@useorgx/wizard 0.1.46 → 0.1.47

package/dist/cli.js

@@ -508,6 +508,31 @@ async function clearWizardAuth(authPath = ORGX_WIZARD_AUTH_PATH, options = {}) {
   return secretRemoved || fileRemoved;
 }
 
+// src/lib/network.ts
+var DEFAULT_REQUEST_TIMEOUT_MS = 12e3;
+function isTimeoutError(error) {
+  if (!(error instanceof Error)) return false;
+  if (error.name === "TimeoutError" || error.name === "AbortError") return true;
+  const message = error.message.toLowerCase();
+  return message.includes("aborted due to timeout") || message.includes("operation was aborted");
+}
+async function fetchWithRetry(url, init, options = {}) {
+  const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+  const retries = options.retries ?? 1;
+  let lastError;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    try {
+      return await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+    } catch (error) {
+      lastError = error;
+      if (!isTimeoutError(error) || attempt === retries) {
+        throw error;
+      }
+    }
+  }
+  throw lastError;
+}
+
 // src/lib/auth.ts
 function normalizeHost(value) {
   return value.trim().toLowerCase().replace(/^\[|\]$/g, "");
@@ -652,14 +677,13 @@ async function parseResponseBody(response) {
 async function verifyOrgxAuth(auth) {
   const url = buildOrgxApiUrl("/client/sync", auth.baseUrl);
   try {
-    const response = await fetch(url, {
+    const response = await fetchWithRetry(url, {
       method: "POST",
       headers: {
         Authorization: `Bearer ${auth.apiKey}`,
         "Content-Type": "application/json"
       },
-      body: "{}",
-      signal: AbortSignal.timeout(7e3)
+      body: "{}"
     });
     const data = await parseResponseBody(response);
     return {
@@ -1177,30 +1201,6 @@ function parseContinuityDefaults(value) {
   }
   return Object.keys(parsed).length > 0 ? parsed : void 0;
 }
-function parseDemoInitiative(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return void 0;
-  }
-  const record = value;
-  if (!isNonEmptyString2(record.id) || !isNonEmptyString2(record.title) || !isNonEmptyString2(record.liveUrl) || !isNonEmptyString2(record.createdAt)) {
-    return void 0;
-  }
-  return {
-    createdAt: record.createdAt.trim(),
-    ...isNonEmptyString2(record.artifactId) ? { artifactId: record.artifactId.trim() } : {},
-    ...isNonEmptyString2(record.artifactName) ? { artifactName: record.artifactName.trim() } : {},
-    ...isNonEmptyString2(record.artifactType) ? { artifactType: record.artifactType.trim() } : {},
-    ...isNonEmptyString2(record.artifactUrl) ? { artifactUrl: record.artifactUrl.trim() } : {},
-    ...isNonEmptyString2(record.decisionId) ? { decisionId: record.decisionId.trim() } : {},
-    ...isNonEmptyString2(record.decisionStatus) ? { decisionStatus: record.decisionStatus.trim() } : {},
-    ...isNonEmptyString2(record.decisionTitle) ? { decisionTitle: record.decisionTitle.trim() } : {},
-    id: record.id.trim(),
-    liveUrl: record.liveUrl.trim(),
-    title: record.title.trim(),
-    ...isNonEmptyString2(record.workspaceId) ? { workspaceId: record.workspaceId.trim() } : {},
-    ...isNonEmptyString2(record.workspaceName) ? { workspaceName: record.workspaceName.trim() } : {}
-  };
-}
 function parseFirstValueInitiative(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return void 0;
@@ -1421,7 +1421,6 @@ function createWizardState(now = (/* @__PURE__ */ new Date()).toISOString()) {
 function sanitizeWizardStateRecord(record) {
   const continuity = parseContinuityDefaults(record.continuity);
   const agentRoster = parseAgentRoster(record.agentRoster);
-  const demoInitiative = parseDemoInitiative(record.demoInitiative);
   const firstValueInitiative = parseFirstValueInitiative(record.firstValueInitiative);
   const onboardingTask = parseOnboardingTask(record.onboardingTask);
   const skillFiles = parseSkillFiles(record.skillFiles);
@@ -1434,7 +1433,6 @@ function sanitizeWizardStateRecord(record) {
     updatedAt: record.updatedAt.trim(),
     ...continuity ? { continuity } : {},
     ...agentRoster ? { agentRoster } : {},
-    ...demoInitiative ? { demoInitiative } : {},
     ...firstValueInitiative ? { firstValueInitiative } : {},
     ...onboardingTask ? { onboardingTask } : {},
     ...skillFiles ? { skillFiles } : {},
@@ -1457,8 +1455,6 @@ function readWizardState(statePath = ORGX_WIZARD_STATE_PATH) {
   if (continuity !== void 0) state.continuity = continuity;
   const agentRoster = parseAgentRoster(parsed.agentRoster);
   if (agentRoster !== void 0) state.agentRoster = agentRoster;
-  const demoInitiative = parseDemoInitiative(parsed.demoInitiative);
-  if (demoInitiative !== void 0) state.demoInitiative = demoInitiative;
   const firstValueInitiative = parseFirstValueInitiative(parsed.firstValueInitiative);
   if (firstValueInitiative !== void 0) {
     state.firstValueInitiative = firstValueInitiative;
@@ -1949,12 +1945,11 @@ function formatHttpError(status, body) {
 async function listWorkspaces(options = {}) {
   const auth = await requireOrgxAuth(options);
   const url = buildOrgxApiUrl("/entities?type=workspace&limit=100", auth.baseUrl);
-  const response = await fetch(url, {
+  const response = await fetchWithRetry(url, {
     method: "GET",
     headers: {
       Authorization: `Bearer ${auth.apiKey}`
-    },
-    signal: AbortSignal.timeout(7e3)
+    }
   });
   const body = await parseResponseBody2(response);
   if (!response.ok) {
@@ -1965,12 +1960,11 @@ async function listWorkspaces(options = {}) {
 async function getCurrentWorkspace(options = {}) {
   const auth = await requireOrgxAuth(options);
   const url = buildOrgxApiUrl("/v1/workspaces/current", auth.baseUrl);
-  const response = await fetch(url, {
+  const response = await fetchWithRetry(url, {
     method: "GET",
     headers: {
       Authorization: `Bearer ${auth.apiKey}`
-    },
-    signal: AbortSignal.timeout(7e3)
+    }
   });
   const body = await parseResponseBody2(response);
   if (response.ok) {
@@ -4594,15 +4588,17 @@ function skippedOpenClawHealth() {
     details: []
   };
 }
-async function runDoctor() {
+async function runDoctor(options = {}) {
   const surfaces = listSurfaceStatuses();
   const openclawSurface = surfaces.find((surface) => surface.name === "openclaw");
-  const auth = await checkOrgxAuth();
-  const hostedMcp = await checkHostedMcpHealth();
-  const hostedMcpTool = await checkHostedMcpToolAccess();
-  const npmRegistry = await checkNpmRegistryHealth();
-  const workspace = await checkWorkspaceConnectivity();
-  const openclaw = openclawSurface?.detected ? await checkOpenClawHealth(openclawSurface.path) : skippedOpenClawHealth();
+  const [auth, hostedMcp, hostedMcpTool, npmRegistry, workspace, openclaw] = await Promise.all([
+    checkOrgxAuth(),
+    checkHostedMcpHealth(),
+    checkHostedMcpToolAccess(),
+    checkNpmRegistryHealth(),
+    options.cachedWorkspace ? Promise.resolve(options.cachedWorkspace) : checkWorkspaceConnectivity(),
+    openclawSurface?.detected ? checkOpenClawHealth(openclawSurface.path) : Promise.resolve(skippedOpenClawHealth())
+  ]);
   return { surfaces, auth, hostedMcp, hostedMcpTool, npmRegistry, workspace, openclaw };
 }
 function assessDoctorReport(report) {
@@ -4745,405 +4741,6 @@ function persistContinuityDefaults(seed = {}, statePath) {
   );
 }
 
-// src/lib/initiatives.ts
-var FOUNDER_DEMO_INITIATIVE_TITLE = "Founder Demo Initiative";
-var FOUNDER_DEMO_INITIATIVE_SUMMARY = "Starter initiative created by @useorgx/wizard to validate workspace routing, live views, and the default OrgX skill pack.";
-var FOUNDER_DEMO_DECISION_TITLE = "Approve founder demo workspace";
-var FOUNDER_DEMO_DECISION_SUMMARY = "Initial decision created by @useorgx/wizard so the founder preset leaves the workspace with a resolved approval trail.";
-var FOUNDER_DEMO_DECISION_RESOLUTION = "Approved automatically by @useorgx/wizard after the founder preset finished creating the live demo workspace.";
-var FOUNDER_DEMO_ARTIFACT_NAME = "Founder Demo Live View";
-var FOUNDER_DEMO_ARTIFACT_TYPE = "document";
-var FOUNDER_DEMO_ARTIFACT_DESCRIPTION = "Live founder demo generated by @useorgx/wizard after workspace bootstrap completed.";
-var ONBOARDING_TASK_TITLE = "Complete OrgX onboarding";
-var ONBOARDING_TASK_SUMMARY = "Starter onboarding task created by @useorgx/wizard so the first workspace has a clear follow-up after setup.";
-var ONBOARDING_WORKSTREAM_TITLE = "OrgX onboarding";
-var ONBOARDING_WORKSTREAM_SUMMARY = "Starter onboarding workstream created by @useorgx/wizard so the first workspace has a home for setup follow-up tasks.";
-var FIRST_VALUE_INITIATIVE_TITLE = "Make OrgX useful on this machine";
-var FIRST_VALUE_INITIATIVE_SUMMARY = "First initiative created by @useorgx/wizard so setup ends with a live workspace, an onboarding workstream, and a clean handoff into the user's configured AI tools.";
-function parseResponseBody3(text2) {
-  if (!text2) {
-    return null;
-  }
-  try {
-    return JSON.parse(text2);
-  } catch {
-    return text2;
-  }
-}
-function formatHttpError2(status, body) {
-  if (typeof body === "string" && body.trim().length > 0) {
-    return `HTTP ${status}: ${body}`;
-  }
-  if (isRecord(body) && typeof body.error === "string" && body.error.trim().length > 0) {
-    return `HTTP ${status}: ${body.error}`;
-  }
-  return `HTTP ${status}`;
-}
-function extractEntity(payload) {
-  const entity = isRecord(payload) && isRecord(payload.data) ? payload.data : payload;
-  if (!isRecord(entity)) {
-    throw new Error("OrgX returned an unexpected entity payload.");
-  }
-  return entity;
-}
-function parseInitiative(payload) {
-  const entity = extractEntity(payload);
-  const id = typeof entity.id === "string" ? entity.id.trim() : "";
-  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
-  if (!id || !title) {
-    throw new Error("OrgX returned an incomplete initiative payload.");
-  }
-  return {
-    id,
-    title,
-    ...typeof entity.summary === "string" && entity.summary.trim().length > 0 ? { summary: entity.summary.trim() } : {}
-  };
-}
-function parseDecision(payload) {
-  const entity = extractEntity(payload);
-  const id = typeof entity.id === "string" ? entity.id.trim() : "";
-  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
-  if (!id || !title) {
-    throw new Error("OrgX returned an incomplete decision payload.");
-  }
-  return {
-    id,
-    title,
-    ...typeof entity.status === "string" && entity.status.trim().length > 0 ? { status: entity.status.trim() } : {},
-    ...typeof entity.summary === "string" && entity.summary.trim().length > 0 ? { summary: entity.summary.trim() } : {}
-  };
-}
-function parseArtifact(payload) {
-  const entity = extractEntity(payload);
-  const id = typeof entity.id === "string" ? entity.id.trim() : "";
-  const name = typeof entity.name === "string" ? entity.name.trim() : typeof entity.title === "string" ? entity.title.trim() : "";
-  const type = typeof entity.artifact_type === "string" ? entity.artifact_type.trim() : typeof entity.type === "string" ? entity.type.trim() : "";
-  const url = typeof entity.external_url === "string" ? entity.external_url.trim() : typeof entity.url === "string" ? entity.url.trim() : "";
-  if (!id || !name) {
-    throw new Error("OrgX returned an incomplete artifact payload.");
-  }
-  return {
-    id,
-    name,
-    ...type ? { type } : {},
-    ...url ? { url } : {}
-  };
-}
-function parseTask(payload) {
-  const entity = extractEntity(payload);
-  const id = typeof entity.id === "string" ? entity.id.trim() : "";
-  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
-  if (!id || !title) {
-    throw new Error("OrgX returned an incomplete task payload.");
-  }
-  return {
-    id,
-    title,
-    ...typeof entity.status === "string" && entity.status.trim().length > 0 ? { status: entity.status.trim() } : {},
-    ...typeof entity.summary === "string" && entity.summary.trim().length > 0 ? { summary: entity.summary.trim() } : {}
-  };
-}
-function parseWorkstream(payload) {
-  const entity = extractEntity(payload);
-  const id = typeof entity.id === "string" ? entity.id.trim() : "";
-  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
-  if (!id || !title) {
-    throw new Error("OrgX returned an incomplete workstream payload.");
-  }
-  return { id, title };
-}
-function toDemoInitiativeRecord(artifact, decision, initiative, liveUrl, workspace) {
-  return {
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    artifactId: artifact.id,
-    artifactName: artifact.name,
-    ...artifact.type ? { artifactType: artifact.type } : {},
-    ...artifact.url ? { artifactUrl: artifact.url } : {},
-    decisionId: decision.id,
-    ...decision.status ? { decisionStatus: decision.status } : {},
-    decisionTitle: decision.title,
-    id: initiative.id,
-    liveUrl,
-    title: initiative.title,
-    workspaceId: workspace.id,
-    workspaceName: workspace.name
-  };
-}
-function toOnboardingTaskRecord(task, workspace, options = {}) {
-  return {
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    id: task.id,
-    ...options.initiativeId ? { initiativeId: options.initiativeId } : {},
-    ...task.status ? { status: task.status } : {},
-    title: task.title,
-    ...options.workstreamId ? { workstreamId: options.workstreamId } : {},
-    workspaceId: workspace.id,
-    workspaceName: workspace.name
-  };
-}
-function toFirstValueInitiativeRecord(initiative, liveUrl, workspace) {
-  return {
-    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-    id: initiative.id,
-    liveUrl,
-    ...initiative.summary ? { summary: initiative.summary } : {},
-    title: initiative.title,
-    workspaceId: workspace.id,
-    workspaceName: workspace.name
-  };
-}
-async function requireOrgxAuth2(options = {}) {
-  const auth = await resolveOrgxAuth(options);
-  if (!auth) {
-    throw new Error(
-      "No OrgX API key configured. Run `wizard auth login` or `wizard auth set-key <oxk_...>` first."
-    );
-  }
-  return auth;
-}
-async function createEntity(type, body, parse2, options = {}) {
-  const auth = await requireOrgxAuth2(options);
-  const response = await fetch(buildOrgxApiUrl("/entities", auth.baseUrl), {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${auth.apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      type,
-      ...body
-    }),
-    signal: AbortSignal.timeout(7e3)
-  });
-  const responseBody = parseResponseBody3(await response.text());
-  if (!response.ok) {
-    throw new Error(`Failed to create ${type}. ${formatHttpError2(response.status, responseBody)}`);
-  }
-  return parse2(responseBody);
-}
-async function updateEntity(type, id, body, parse2, options = {}) {
-  const auth = await requireOrgxAuth2(options);
-  const response = await fetch(buildOrgxApiUrl("/entities", auth.baseUrl), {
-    method: "PATCH",
-    headers: {
-      Authorization: `Bearer ${auth.apiKey}`,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({
-      type,
-      id,
-      ...body
-    }),
-    signal: AbortSignal.timeout(7e3)
-  });
-  const responseBody = parseResponseBody3(await response.text());
-  if (!response.ok) {
-    throw new Error(`Failed to update ${type}. ${formatHttpError2(response.status, responseBody)}`);
-  }
-  return parse2(responseBody);
-}
-function buildLiveUrl(baseUrl, initiativeId) {
-  const parsed = new URL(normalizeOrgxBaseUrl(baseUrl));
-  parsed.pathname = `/live/${initiativeId}`;
-  parsed.search = "";
-  parsed.hash = "";
-  return parsed.toString();
-}
-async function createFounderDemoDecision(initiative, workspaceId, options = {}) {
-  return createEntity(
-    "decision",
-    {
-      initiative_id: initiative.id,
-      summary: FOUNDER_DEMO_DECISION_SUMMARY,
-      title: FOUNDER_DEMO_DECISION_TITLE,
-      workspace_id: workspaceId
-    },
-    parseDecision,
-    options
-  );
-}
-async function approveFounderDemoDecision(decisionId, options = {}) {
-  return updateEntity(
-    "decision",
-    decisionId,
-    {
-      resolution_summary: FOUNDER_DEMO_DECISION_RESOLUTION,
-      status: "approved"
-    },
-    parseDecision,
-    options
-  );
-}
-async function createFounderDemoArtifact(initiative, liveUrl, workspaceId, options = {}) {
-  return createEntity(
-    "artifact",
-    {
-      artifact_type: FOUNDER_DEMO_ARTIFACT_TYPE,
-      description: FOUNDER_DEMO_ARTIFACT_DESCRIPTION,
-      entity_id: initiative.id,
-      entity_type: "initiative",
-      external_url: liveUrl,
-      initiative_id: initiative.id,
-      name: FOUNDER_DEMO_ARTIFACT_NAME,
-      workspace_id: workspaceId
-    },
-    parseArtifact,
-    options
-  );
-}
-async function createInitiative(input, options = {}) {
-  const title = input.title.trim();
-  if (!title) {
-    throw new Error("Initiative title is required.");
-  }
-  return createEntity(
-    "initiative",
-    {
-      title,
-      status: "active",
-      ...input.summary?.trim() ? { summary: input.summary.trim() } : {},
-      ...input.workspaceId?.trim() ? { workspace_id: input.workspaceId.trim() } : {}
-    },
-    parseInitiative,
-    options
-  );
-}
-async function ensureFounderDemoInitiative(workspace, options = {}) {
-  const existingRecord = readWizardState(options.statePath)?.demoInitiative;
-  const matchingRecord = existingRecord?.workspaceId === workspace.id ? existingRecord : void 0;
-  const auth = await requireOrgxAuth2(options);
-  const initiative = matchingRecord ? {
-    id: matchingRecord.id,
-    title: matchingRecord.title
-  } : await createInitiative(
-    {
-      title: FOUNDER_DEMO_INITIATIVE_TITLE,
-      summary: FOUNDER_DEMO_INITIATIVE_SUMMARY,
-      workspaceId: workspace.id
-    },
-    options
-  );
-  const liveUrl = matchingRecord?.liveUrl || buildLiveUrl(auth.baseUrl, initiative.id);
-  const decision = matchingRecord?.decisionId ? matchingRecord.decisionStatus === "approved" && matchingRecord.decisionTitle ? {
-    id: matchingRecord.decisionId,
-    status: matchingRecord.decisionStatus,
-    title: matchingRecord.decisionTitle
-  } : await approveFounderDemoDecision(matchingRecord.decisionId, options) : await approveFounderDemoDecision(
-    (await createFounderDemoDecision(initiative, workspace.id, options)).id,
-    options
-  );
-  const artifact = matchingRecord?.artifactId && matchingRecord.artifactName ? {
-    id: matchingRecord.artifactId,
-    name: matchingRecord.artifactName,
-    ...matchingRecord.artifactType ? { type: matchingRecord.artifactType } : {},
-    ...matchingRecord.artifactUrl ? { url: matchingRecord.artifactUrl } : {}
-  } : await createFounderDemoArtifact(initiative, liveUrl, workspace.id, options);
-  const record = toDemoInitiativeRecord(artifact, decision, initiative, liveUrl, workspace);
-  updateWizardState(
-    (current) => ({
-      ...current,
-      demoInitiative: record
-    }),
-    options.statePath
-  );
-  return {
-    artifact,
-    created: !matchingRecord,
-    decision,
-    initiative,
-    liveUrl
-  };
-}
-async function ensureFirstValueInitiative(workspace, options = {}) {
-  const existingRecord = readWizardState(options.statePath)?.firstValueInitiative;
-  const matchingRecord = existingRecord?.workspaceId === workspace.id ? existingRecord : void 0;
-  const auth = await requireOrgxAuth2(options);
-  if (matchingRecord) {
-    return {
-      created: false,
-      initiative: {
-        id: matchingRecord.id,
-        title: matchingRecord.title,
-        ...matchingRecord.summary ? { summary: matchingRecord.summary } : {}
-      },
-      liveUrl: matchingRecord.liveUrl || buildLiveUrl(auth.baseUrl, matchingRecord.id)
-    };
-  }
-  const initiative = await createInitiative(
-    {
-      title: options.title?.trim() || FIRST_VALUE_INITIATIVE_TITLE,
-      summary: options.summary?.trim() || FIRST_VALUE_INITIATIVE_SUMMARY,
-      workspaceId: workspace.id
-    },
-    options
-  );
-  const liveUrl = buildLiveUrl(auth.baseUrl, initiative.id);
-  updateWizardState(
-    (current) => ({
-      ...current,
-      firstValueInitiative: toFirstValueInitiativeRecord(initiative, liveUrl, workspace)
-    }),
-    options.statePath
-  );
-  return {
-    created: true,
-    initiative,
-    liveUrl
-  };
-}
-async function ensureOnboardingTask(workspace, options = {}) {
-  const existingRecord = readWizardState(options.statePath)?.onboardingTask;
-  if (existingRecord?.workspaceId === workspace.id) {
-    return {
-      id: existingRecord.id,
-      title: existingRecord.title,
-      ...existingRecord.status ? { status: existingRecord.status } : {}
-    };
-  }
-  const initiativeId = options.initiativeId?.trim();
-  if (!initiativeId) {
-    throw new Error(
-      "Starter onboarding task requires an initiative context. Re-run setup with the founder preset or create an initiative before requesting onboarding tasks."
-    );
-  }
-  const workstream = await createEntity(
-    "workstream",
-    {
-      initiative_id: initiativeId,
-      status: "active",
-      summary: ONBOARDING_WORKSTREAM_SUMMARY,
-      title: ONBOARDING_WORKSTREAM_TITLE,
-      workspace_id: workspace.id
-    },
-    parseWorkstream,
-    options
-  );
-  const task = await createEntity(
-    "task",
-    {
-      initiative_id: initiativeId,
-      status: "todo",
-      summary: ONBOARDING_TASK_SUMMARY,
-      title: ONBOARDING_TASK_TITLE,
-      workstream_id: workstream.id,
-      workspace_id: workspace.id
-    },
-    parseTask,
-    options
-  );
-  updateWizardState(
-    (current) => ({
-      ...current,
-      onboardingTask: toOnboardingTaskRecord(task, workspace, {
-        initiativeId,
-        workstreamId: workstream.id
-      })
-    }),
-    options.statePath
-  );
-  return task;
-}
-
 // src/lib/setup-workspace.ts
 var CREATE_WORKSPACE_VALUE = "__create_workspace__";
 var SKIP_WORKSPACE_VALUE = "__skip_workspace__";
@@ -5317,79 +4914,309 @@ async function runWorkspaceSetup(client, prompts, options) {
   if (typeof selected !== "string") {
     return cancelResult(prompts);
   }
-  if (selected === SKIP_WORKSPACE_VALUE) {
-    return {
-      message: "Workspace bootstrap skipped.",
-      status: "skipped",
-      ...currentWorkspace ? { workspace: currentWorkspace } : {}
-    };
+  if (selected === SKIP_WORKSPACE_VALUE) {
+    return {
+      message: "Workspace bootstrap skipped.",
+      status: "skipped",
+      ...currentWorkspace ? { workspace: currentWorkspace } : {}
+    };
+  }
+  if (selected === CREATE_WORKSPACE_VALUE) {
+    return createAndSelectWorkspace(client, prompts);
+  }
+  const chosenWorkspace = workspaces.find((workspace) => workspace.id === selected);
+  if (!chosenWorkspace) {
+    throw new Error(`Selected workspace ${selected} is no longer available.`);
+  }
+  if (chosenWorkspace.isDefault) {
+    return {
+      defaultChanged: false,
+      message: `"${chosenWorkspace.name}" is already the default OrgX workspace.`,
+      status: "unchanged",
+      workspace: chosenWorkspace
+    };
+  }
+  const promoted = await client.setDefaultWorkspace({ id: chosenWorkspace.id });
+  return {
+    defaultChanged: promoted.changed,
+    message: `Set "${promoted.workspace.name}" as the default OrgX workspace.`,
+    status: promoted.changed ? "updated" : "unchanged",
+    workspace: promoted.workspace
+  };
+}
+
+// src/lib/founder-preset.ts
+async function runFounderPreset(prompts, options) {
+  const surfaceResults = await setupDetectedSurfaces();
+  const pluginTargets = options.pluginTargets ?? (await listOrgxPluginStatuses()).filter((status) => status.installed).map((status) => status.target);
+  const skillReport = await installOrgxSkills({
+    pluginTargets,
+    skillNames: [...DEFAULT_ORGX_SKILL_PACKS]
+  });
+  let workspaceSetup;
+  let workspace = await getCurrentWorkspace().catch(() => null);
+  if (workspace || options.interactive) {
+    workspaceSetup = await runWorkspaceSetup(
+      {
+        createWorkspace,
+        getCurrentWorkspace,
+        listWorkspaces,
+        setDefaultWorkspace
+      },
+      prompts,
+      options
+    );
+    if (workspaceSetup.status === "cancelled") {
+      return workspaceSetup;
+    }
+    workspace = workspaceSetup.workspace ?? workspace ?? await getCurrentWorkspace().catch(() => null);
+  }
+  const continuity = persistContinuityDefaults({
+    statuses: listSurfaceStatuses(),
+    workspace
+  });
+  return {
+    continuity,
+    skillReport,
+    surfaceResults,
+    workspace,
+    ...workspaceSetup ? { workspaceSetup } : {}
+  };
+}
+
+// src/lib/initiatives.ts
+var ONBOARDING_TASK_TITLE = "Complete OrgX onboarding";
+var ONBOARDING_TASK_SUMMARY = "Starter onboarding task created by @useorgx/wizard so the first workspace has a clear follow-up after setup.";
+var ONBOARDING_WORKSTREAM_TITLE = "OrgX onboarding";
+var ONBOARDING_WORKSTREAM_SUMMARY = "Starter onboarding workstream created by @useorgx/wizard so the first workspace has a home for setup follow-up tasks.";
+var FIRST_VALUE_INITIATIVE_TITLE = "Make OrgX useful on this machine";
+var FIRST_VALUE_INITIATIVE_SUMMARY = "First initiative created by @useorgx/wizard so setup ends with a live workspace, an onboarding workstream, and a clean handoff into the user's configured AI tools.";
+function parseResponseBody3(text2) {
+  if (!text2) {
+    return null;
+  }
+  try {
+    return JSON.parse(text2);
+  } catch {
+    return text2;
+  }
+}
+function formatHttpError2(status, body) {
+  if (typeof body === "string" && body.trim().length > 0) {
+    return `HTTP ${status}: ${body}`;
+  }
+  if (isRecord(body) && typeof body.error === "string" && body.error.trim().length > 0) {
+    return `HTTP ${status}: ${body.error}`;
+  }
+  return `HTTP ${status}`;
+}
+function extractEntity(payload) {
+  const entity = isRecord(payload) && isRecord(payload.data) ? payload.data : payload;
+  if (!isRecord(entity)) {
+    throw new Error("OrgX returned an unexpected entity payload.");
+  }
+  return entity;
+}
+function parseInitiative(payload) {
+  const entity = extractEntity(payload);
+  const id = typeof entity.id === "string" ? entity.id.trim() : "";
+  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
+  if (!id || !title) {
+    throw new Error("OrgX returned an incomplete initiative payload.");
+  }
+  return {
+    id,
+    title,
+    ...typeof entity.summary === "string" && entity.summary.trim().length > 0 ? { summary: entity.summary.trim() } : {}
+  };
+}
+function parseTask(payload) {
+  const entity = extractEntity(payload);
+  const id = typeof entity.id === "string" ? entity.id.trim() : "";
+  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
+  if (!id || !title) {
+    throw new Error("OrgX returned an incomplete task payload.");
+  }
+  return {
+    id,
+    title,
+    ...typeof entity.status === "string" && entity.status.trim().length > 0 ? { status: entity.status.trim() } : {},
+    ...typeof entity.summary === "string" && entity.summary.trim().length > 0 ? { summary: entity.summary.trim() } : {}
+  };
+}
+function parseWorkstream(payload) {
+  const entity = extractEntity(payload);
+  const id = typeof entity.id === "string" ? entity.id.trim() : "";
+  const title = typeof entity.title === "string" ? entity.title.trim() : typeof entity.name === "string" ? entity.name.trim() : "";
+  if (!id || !title) {
+    throw new Error("OrgX returned an incomplete workstream payload.");
+  }
+  return { id, title };
+}
+function toOnboardingTaskRecord(task, workspace, options = {}) {
+  return {
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    id: task.id,
+    ...options.initiativeId ? { initiativeId: options.initiativeId } : {},
+    ...task.status ? { status: task.status } : {},
+    title: task.title,
+    ...options.workstreamId ? { workstreamId: options.workstreamId } : {},
+    workspaceId: workspace.id,
+    workspaceName: workspace.name
+  };
+}
+function toFirstValueInitiativeRecord(initiative, liveUrl, workspace) {
+  return {
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    id: initiative.id,
+    liveUrl,
+    ...initiative.summary ? { summary: initiative.summary } : {},
+    title: initiative.title,
+    workspaceId: workspace.id,
+    workspaceName: workspace.name
+  };
+}
+async function requireOrgxAuth2(options = {}) {
+  const auth = await resolveOrgxAuth(options);
+  if (!auth) {
+    throw new Error(
+      "No OrgX API key configured. Run `wizard auth login` or `wizard auth set-key <oxk_...>` first."
+    );
   }
-  if (selected === CREATE_WORKSPACE_VALUE) {
-    return createAndSelectWorkspace(client, prompts);
+  return auth;
+}
+async function createEntity(type, body, parse2, options = {}) {
+  const auth = await requireOrgxAuth2(options);
+  const response = await fetch(buildOrgxApiUrl("/entities", auth.baseUrl), {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${auth.apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      type,
+      ...body
+    }),
+    signal: AbortSignal.timeout(7e3)
+  });
+  const responseBody = parseResponseBody3(await response.text());
+  if (!response.ok) {
+    throw new Error(`Failed to create ${type}. ${formatHttpError2(response.status, responseBody)}`);
   }
-  const chosenWorkspace = workspaces.find((workspace) => workspace.id === selected);
-  if (!chosenWorkspace) {
-    throw new Error(`Selected workspace ${selected} is no longer available.`);
+  return parse2(responseBody);
+}
+function buildLiveUrl(baseUrl, initiativeId) {
+  const parsed = new URL(normalizeOrgxBaseUrl(baseUrl));
+  parsed.pathname = `/live/${initiativeId}`;
+  parsed.search = "";
+  parsed.hash = "";
+  return parsed.toString();
+}
+async function createInitiative(input, options = {}) {
+  const title = input.title.trim();
+  if (!title) {
+    throw new Error("Initiative title is required.");
   }
-  if (chosenWorkspace.isDefault) {
+  return createEntity(
+    "initiative",
+    {
+      title,
+      status: "active",
+      ...input.summary?.trim() ? { summary: input.summary.trim() } : {},
+      ...input.workspaceId?.trim() ? { workspace_id: input.workspaceId.trim() } : {}
+    },
+    parseInitiative,
+    options
+  );
+}
+async function ensureFirstValueInitiative(workspace, options = {}) {
+  const existingRecord = readWizardState(options.statePath)?.firstValueInitiative;
+  const matchingRecord = existingRecord?.workspaceId === workspace.id ? existingRecord : void 0;
+  const auth = await requireOrgxAuth2(options);
+  if (matchingRecord) {
     return {
-      defaultChanged: false,
-      message: `"${chosenWorkspace.name}" is already the default OrgX workspace.`,
-      status: "unchanged",
-      workspace: chosenWorkspace
+      created: false,
+      initiative: {
+        id: matchingRecord.id,
+        title: matchingRecord.title,
+        ...matchingRecord.summary ? { summary: matchingRecord.summary } : {}
+      },
+      liveUrl: matchingRecord.liveUrl || buildLiveUrl(auth.baseUrl, matchingRecord.id)
     };
   }
-  const promoted = await client.setDefaultWorkspace({ id: chosenWorkspace.id });
+  const initiative = await createInitiative(
+    {
+      title: options.title?.trim() || FIRST_VALUE_INITIATIVE_TITLE,
+      summary: options.summary?.trim() || FIRST_VALUE_INITIATIVE_SUMMARY,
+      workspaceId: workspace.id
+    },
+    options
+  );
+  const liveUrl = buildLiveUrl(auth.baseUrl, initiative.id);
+  updateWizardState(
+    (current) => ({
+      ...current,
+      firstValueInitiative: toFirstValueInitiativeRecord(initiative, liveUrl, workspace)
+    }),
+    options.statePath
+  );
   return {
-    defaultChanged: promoted.changed,
-    message: `Set "${promoted.workspace.name}" as the default OrgX workspace.`,
-    status: promoted.changed ? "updated" : "unchanged",
-    workspace: promoted.workspace
+    created: true,
+    initiative,
+    liveUrl
   };
 }
-
-// src/lib/founder-preset.ts
-async function runFounderPreset(prompts, options) {
-  const surfaceResults = await setupDetectedSurfaces();
-  const pluginTargets = options.pluginTargets ?? (await listOrgxPluginStatuses()).filter((status) => status.installed).map((status) => status.target);
-  const skillReport = await installOrgxSkills({
-    pluginTargets,
-    skillNames: [...DEFAULT_ORGX_SKILL_PACKS]
-  });
-  let workspaceSetup;
-  let workspace = await getCurrentWorkspace().catch(() => null);
-  if (workspace || options.interactive) {
-    workspaceSetup = await runWorkspaceSetup(
-      {
-        createWorkspace,
-        getCurrentWorkspace,
-        listWorkspaces,
-        setDefaultWorkspace
-      },
-      prompts,
-      options
-    );
-    if (workspaceSetup.status === "cancelled") {
-      return workspaceSetup;
-    }
-    workspace = workspaceSetup.workspace ?? workspace ?? await getCurrentWorkspace().catch(() => null);
+async function ensureOnboardingTask(workspace, options = {}) {
+  const existingRecord = readWizardState(options.statePath)?.onboardingTask;
+  if (existingRecord?.workspaceId === workspace.id) {
+    return {
+      id: existingRecord.id,
+      title: existingRecord.title,
+      ...existingRecord.status ? { status: existingRecord.status } : {}
+    };
   }
-  const continuity = persistContinuityDefaults({
-    statuses: listSurfaceStatuses(),
-    workspace
-  });
-  let demoInitiative;
-  if (workspace) {
-    demoInitiative = await ensureFounderDemoInitiative(workspace);
+  const initiativeId = options.initiativeId?.trim();
+  if (!initiativeId) {
+    throw new Error(
+      "Starter onboarding task requires an initiative context. Re-run setup with the founder preset or create an initiative before requesting onboarding tasks."
+    );
   }
-  return {
-    continuity,
-    ...demoInitiative ? { demoInitiative } : {},
-    skillReport,
-    surfaceResults,
-    workspace,
-    ...workspaceSetup ? { workspaceSetup } : {}
-  };
+  const workstream = await createEntity(
+    "workstream",
+    {
+      initiative_id: initiativeId,
+      status: "active",
+      summary: ONBOARDING_WORKSTREAM_SUMMARY,
+      title: ONBOARDING_WORKSTREAM_TITLE,
+      workspace_id: workspace.id
+    },
+    parseWorkstream,
+    options
+  );
+  const task = await createEntity(
+    "task",
+    {
+      initiative_id: initiativeId,
+      status: "todo",
+      summary: ONBOARDING_TASK_SUMMARY,
+      title: ONBOARDING_TASK_TITLE,
+      workstream_id: workstream.id,
+      workspace_id: workspace.id
+    },
+    parseTask,
+    options
+  );
+  updateWizardState(
+    (current) => ({
+      ...current,
+      onboardingTask: toOnboardingTaskRecord(task, workspace, {
+        initiativeId,
+        workstreamId: workstream.id
+      })
+    }),
+    options.statePath
+  );
+  return task;
 }
 
 // src/lib/local-skill-discovery.ts
@@ -5607,6 +5434,9 @@ var HOSTED_MCP_OUTAGE_TITLE = "Hosted OrgX MCP is unreachable.";
 function getSetupVerificationHeadline(summary) {
   switch (summary.status) {
     case "degraded":
+      if (summary.transientTimeouts) {
+        return "OrgX servers were slow to respond \u2014 setup applied, but the final health check timed out. Re-run `wizard doctor` in a moment to confirm.";
+      }
       return "Hosted OrgX MCP is down; local setup can still continue.";
     case "error":
       return "Issues detected";
@@ -5616,18 +5446,50 @@ function getSetupVerificationHeadline(summary) {
       return "All systems ready.";
   }
 }
-function summarizeSetupVerification(assessment) {
+function isTimeoutErrorString(value) {
+  if (!value) return false;
+  return isTimeoutError(new Error(value));
+}
+function reportErrorsAreOnlyTimeouts(report) {
+  if (!report) return false;
+  const authTimedOut = !report.auth.ok && !report.auth.skipped && isTimeoutErrorString(report.auth.error);
+  const workspaceTimedOut = !report.workspace.ok && !report.workspace.skipped && isTimeoutErrorString(report.workspace.error);
+  const reachableServicesOk = (report.hostedMcp.skipped || report.hostedMcp.ok) && (report.openclaw.skipped || report.openclaw.ok);
+  return reachableServicesOk && (authTimedOut || workspaceTimedOut);
+}
+function summarizeSetupVerification(assessment, report) {
   const errors = assessment.issues.filter((issue) => issue.level === "error");
   if (errors.length === 0) {
     return {
       hostedMcpDegraded: false,
+      transientTimeouts: false,
       status: assessment.issues.length > 0 ? "warning" : "ok"
     };
   }
   const hostedMcpDegraded = errors.every((issue) => issue.title === HOSTED_MCP_OUTAGE_TITLE);
+  if (hostedMcpDegraded) {
+    return {
+      hostedMcpDegraded: true,
+      transientTimeouts: false,
+      status: "degraded"
+    };
+  }
+  const authOrWorkspaceTitles = /* @__PURE__ */ new Set([
+    "OrgX user auth could not be verified.",
+    "Current workspace lookup failed."
+  ]);
+  const onlyAuthOrWorkspaceErrors = errors.every((issue) => authOrWorkspaceTitles.has(issue.title));
+  if (onlyAuthOrWorkspaceErrors && reportErrorsAreOnlyTimeouts(report)) {
+    return {
+      hostedMcpDegraded: false,
+      transientTimeouts: true,
+      status: "degraded"
+    };
+  }
   return {
-    hostedMcpDegraded,
-    status: hostedMcpDegraded ? "degraded" : "error"
+    hostedMcpDegraded: false,
+    transientTimeouts: false,
+    status: "error"
   };
 }
 
@@ -5669,16 +5531,6 @@ function buildAgentRosterTelemetryProperties(input, base = {}) {
     base
   );
 }
-function buildFounderDemoTelemetryProperties(result, base = {}) {
-  return withBaseProperties(
-    {
-      created: result.created,
-      decision_status: result.decision.status ?? "unknown",
-      has_artifact_url: Boolean(result.artifact.url)
-    },
-    base
-  );
-}
 function buildFirstValueInitiativeTelemetryProperties(result, base = {}) {
   return withBaseProperties(
     {
@@ -5701,6 +5553,7 @@ function buildDoctorTelemetryProperties(report, assessment, verification, base =
       hosted_mcp_degraded: verification.hostedMcpDegraded,
       hosted_mcp_ok: report.hostedMcp.ok,
       hosted_mcp_tool_ok: report.hostedMcpTool.ok,
+      transient_timeouts: verification.transientTimeouts,
       issue_count: assessment.issues.length,
       openclaw_available: !report.openclaw.skipped,
       openclaw_ok: report.openclaw.ok,
@@ -14050,20 +13903,6 @@ function printFounderPresetResult(result) {
     console.log("");
     printWorkspaceSetupResult(result.workspaceSetup);
   }
-  if (result.demoInitiative) {
-    console.log("");
-    console.log(pc3.bold("demo initiative"));
-    console.log(
-      `  ${result.demoInitiative.created ? pc3.green("created") : pc3.yellow("unchanged")} ${result.demoInitiative.initiative.title}`
-    );
-    console.log(`  live: ${result.demoInitiative.liveUrl}`);
-    console.log(
-      `  decision: ${result.demoInitiative.decision.title} ${pc3.dim(`(${result.demoInitiative.decision.status ?? "pending"})`)}`
-    );
-    console.log(
-      `  artifact: ${result.demoInitiative.artifact.name}${result.demoInitiative.artifact.url ? ` ${pc3.dim(result.demoInitiative.artifact.url)}` : ""}`
-    );
-  }
 }
 function normalizePromptResult(value) {
   return value;
@@ -14488,10 +14327,9 @@ async function maybeConfigureOptionalWorkspaceAddOns(input) {
   }
   const existingState = readWizardState();
   const providedInitiativeId = input.initiativeId?.trim();
-  const storedDemoInitiative = existingState?.demoInitiative?.workspaceId === input.workspace.id ? existingState.demoInitiative : void 0;
   const storedFirstValueInitiative = existingState?.firstValueInitiative?.workspaceId === input.workspace.id ? existingState.firstValueInitiative : void 0;
-  let effectiveInitiativeId = providedInitiativeId || storedDemoInitiative?.id || storedFirstValueInitiative?.id;
-  let firstValueInitiative = providedInitiativeId || storedDemoInitiative ? null : firstValueRecordToResult(storedFirstValueInitiative);
+  let effectiveInitiativeId = providedInitiativeId || storedFirstValueInitiative?.id;
+  let firstValueInitiative = providedInitiativeId ? null : firstValueRecordToResult(storedFirstValueInitiative);
   const firstInitiativeSkipped = hasSetupPromptSkip(
     input.workspace.id,
     "first_initiative"
@@ -14845,7 +14683,7 @@ function printAuthStatus(status) {
   }
 }
 function printDoctorReport(report, assessment) {
-  const verification = summarizeSetupVerification(assessment);
+  const verification = summarizeSetupVerification(assessment, report);
   console.log(pc3.dim("  surfaces"));
   printSurfaceTable(report.surfaces);
   console.log("");
@@ -14893,6 +14731,9 @@ function printDoctorReport(report, assessment) {
     } else {
       console.log(`  ${pc3.dim("\u2192")}  ${pc3.dim(`OrgX is active across ${configuredCount} editor${configuredCount !== 1 ? "s" : ""}`)}`);
     }
+  } else if (verification.transientTimeouts) {
+    console.log(`  ${ICON.warn}  ${pc3.yellow(getSetupVerificationHeadline(verification))}`);
+    console.log(`  ${pc3.dim("\u2192")}  ${pc3.cyan(`${getCmd()} doctor`)}  ${pc3.dim("re-runs the health checks")}`);
   } else {
     const headlineText = getSetupVerificationHeadline(verification);
     const headline = verification.status === "error" ? `${ICON.err}  ${pc3.red(headlineText)}` : `${ICON.warn}  ${pc3.yellow(headlineText)}`;
@@ -14909,7 +14750,7 @@ function printDoctorReport(report, assessment) {
 async function main() {
   const program = new Command();
   program.name("orgx-wizard").description("Add OrgX MCP configs, skills/rules, and companion plugins to your local AI tools.").showHelpAfterError();
-  const pkgVersion = true ? "0.1.46" : void 0;
+  const pkgVersion = true ? "0.1.47" : void 0;
   program.version(pkgVersion ?? "unknown", "-V, --version");
   program.hook("preAction", (_thisCommand, actionCommand) => {
     if (Boolean(actionCommand.optsWithGlobals().json)) return;
@@ -14988,22 +14829,12 @@ async function main() {
           })
         );
       }
-      if (presetResult.demoInitiative) {
-        await safeTrackWizardTelemetry(
-          "founder_demo_ready",
-          buildFounderDemoTelemetryProperties(presetResult.demoInitiative, {
-            command: "setup",
-            preset: "founder"
-          })
-        );
-      }
       const addOnResult = await maybeConfigureOptionalWorkspaceAddOns({
         ...setupContext ? { context: setupContext } : {},
         interactive,
         profile: setupProfile,
         telemetry: { command: "setup", preset: "founder" },
-        workspace: presetResult.workspace,
-        ...presetResult.demoInitiative ? { initiativeId: presetResult.demoInitiative.initiative.id } : {}
+        workspace: presetResult.workspace
       });
       if (addOnResult === "cancelled") {
         return;
@@ -15015,7 +14846,7 @@ async function main() {
       console.log("");
       const doctor2 = await runDoctor();
       const assessment2 = assessDoctorReport(doctor2);
-      const verification2 = summarizeSetupVerification(assessment2);
+      const verification2 = summarizeSetupVerification(assessment2, doctor2);
       await safeTrackWizardTelemetry(
         "setup_verified",
         buildDoctorTelemetryProperties(doctor2, assessment2, verification2, {
@@ -15042,6 +14873,7 @@ async function main() {
     });
     const wasAlreadyPaired = await resolveOrgxAuth() !== null;
     let resolvedAuth = await resolveOrgxAuth();
+    let cachedWorkspaceCheck;
     if (!resolvedAuth) {
       console.log("");
       if (interactive) {
@@ -15125,6 +14957,20 @@ async function main() {
         })
       );
       const resolvedWorkspace = workspaceSetup.workspace ?? await getCurrentWorkspace().catch(() => null);
+      if (resolvedWorkspace && resolvedAuth) {
+        cachedWorkspaceCheck = {
+          configured: true,
+          ok: true,
+          skipped: false,
+          source: resolvedAuth.source,
+          baseUrl: resolvedAuth.baseUrl,
+          workspace: resolvedWorkspace,
+          details: [
+            `workspace id: ${resolvedWorkspace.id}`,
+            ...resolvedWorkspace.isDefault ? ["workspace is marked as default"] : []
+          ]
+        };
+      }
       if (resolvedWorkspace) {
         persistContinuityDefaults({ workspace: resolvedWorkspace });
       }
@@ -15179,9 +15025,11 @@ async function main() {
         return;
       }
     }
-    const doctor = await runDoctor();
+    const doctor = await runDoctor(
+      cachedWorkspaceCheck ? { cachedWorkspace: cachedWorkspaceCheck } : {}
+    );
     const assessment = assessDoctorReport(doctor);
-    const verification = summarizeSetupVerification(assessment);
+    const verification = summarizeSetupVerification(assessment, doctor);
     await safeTrackWizardTelemetry(
       "setup_verified",
       buildDoctorTelemetryProperties(doctor, assessment, verification, {
@@ -15698,7 +15546,7 @@ async function main() {
     const report = await runDoctor();
     spinner.stop();
     const assessment = assessDoctorReport(report);
-    const verification = summarizeSetupVerification(assessment);
+    const verification = summarizeSetupVerification(assessment, report);
     await safeTrackWizardTelemetry(
       "doctor_ran",
       buildDoctorTelemetryProperties(report, assessment, verification, {