ofiere-openclaw-plugin 4.54.1 → 4.55.0

package/src/sop-render.ts

@@ -1,216 +1,216 @@
-// src/sop-render.ts — Plugin-side markdown renderer for SOPs and Frameworks.
-// Mirrors dashboard/lib/sopRender.ts. Output is what gets prepended/appended to
-// the system prompt during `before_prompt_build`.
-
-interface SOPCheckItem { text?: string; checked?: boolean; }
-interface SOPStep {
-  name?: string; action?: string; owner?: string; output?: string;
-  decision_logic?: string; failure_state?: string; fallback_action?: string;
-  estimated_duration?: string;
-}
-interface SOPEscalationRule { trigger?: string; escalateTo?: string; priority?: string; }
-interface SOPPrerequisites {
-  conditions?: SOPCheckItem[]; required_tools?: string[];
-  required_permissions?: string[]; safety_warnings?: string[];
-}
-export interface SOPData {
-  title?: string;
-  purpose?: string; scope?: string; applicability?: string;
-  prerequisites?: SOPPrerequisites;
-  procedure_steps?: SOPStep[];
-  expected_outputs?: string[];
-  acceptance_criteria?: SOPCheckItem[];
-  escalation_rules?: SOPEscalationRule[];
-  rollback_procedure?: string;
-  notes?: string;
-}
-
-interface FrameworkObjective {
-  objective?: string; target?: string; measurement?: string; frequency?: string;
-}
-interface FrameworkEscalation {
-  trigger?: string; escalate_to?: string; priority?: string; response_sla?: string;
-}
-export interface FrameworkData {
-  title?: string;
-  mission?: string; vision?: string;
-  core_principles?: string[];
-  decision_authority?: string; budget_constraints?: string;
-  resource_limits?: string; tool_stack?: string[];
-  strategic_objectives?: FrameworkObjective[];
-  risk_appetite?: string; compliance_requirements?: string[];
-  escalation_matrix?: FrameworkEscalation[];
-  team_composition?: string; integration_points?: string[];
-  review_frequency?: string; last_reviewed?: string; next_review?: string;
-  notes?: string;
-}
-
-function bullet(items: (string | undefined | null)[]): string {
-  const cleaned = items.map((s) => (s ?? "").toString().trim()).filter(Boolean);
-  return cleaned.length ? cleaned.map((s) => `- ${s}`).join("\n") : "";
-}
-
-function section(label: string, body: string): string {
-  const trimmed = body.trim();
-  return trimmed ? `### ${label}\n${trimmed}` : "";
-}
-
-function joinSections(parts: string[]): string {
-  return parts.filter(Boolean).join("\n\n");
-}
-
-function safeParse<T = unknown>(s: string): T | null {
-  try { return JSON.parse(s) as T; } catch { return null; }
-}
-
-export function renderSopMarkdown(input: string | SOPData | null | undefined): string {
-  if (input == null) return "";
-  const data: SOPData = typeof input === "string"
-    ? (safeParse<SOPData>(input) || {})
-    : input;
-
-  const parts: string[] = [];
-  if (data.purpose) parts.push(section("Purpose", data.purpose));
-  if (data.scope) parts.push(section("Scope", data.scope));
-  if (data.applicability) parts.push(section("Applicability", data.applicability));
-
-  const prereq = data.prerequisites;
-  if (prereq) {
-    const pieces: string[] = [];
-    const cond = (prereq.conditions || []).map((c) => c?.text).filter(Boolean) as string[];
-    if (cond.length) pieces.push(`**Conditions:**\n${bullet(cond)}`);
-    if (prereq.required_tools?.length) pieces.push(`**Required tools:**\n${bullet(prereq.required_tools)}`);
-    if (prereq.required_permissions?.length) pieces.push(`**Required permissions:**\n${bullet(prereq.required_permissions)}`);
-    if (prereq.safety_warnings?.length) pieces.push(`**Safety warnings:**\n${bullet(prereq.safety_warnings)}`);
-    if (pieces.length) parts.push(section("Prerequisites", pieces.join("\n\n")));
-  }
-
-  if (data.procedure_steps?.length) {
-    const steps = data.procedure_steps.map((step, i) => {
-      const lines: string[] = [`${i + 1}. **${step.name || `Step ${i + 1}`}**`];
-      if (step.action) lines.push(`   - Action: ${step.action}`);
-      if (step.owner) lines.push(`   - Owner: ${step.owner}`);
-      if (step.output) lines.push(`   - Output: ${step.output}`);
-      if (step.decision_logic) lines.push(`   - Decision logic: ${step.decision_logic}`);
-      if (step.failure_state) lines.push(`   - Failure state: ${step.failure_state}`);
-      if (step.fallback_action) lines.push(`   - Fallback: ${step.fallback_action}`);
-      if (step.estimated_duration) lines.push(`   - ETA: ${step.estimated_duration}`);
-      return lines.join("\n");
-    }).join("\n");
-    parts.push(section("Procedure", steps));
-  }
-
-  if (data.expected_outputs?.length) parts.push(section("Expected Outputs", bullet(data.expected_outputs)));
-  if (data.acceptance_criteria?.length) {
-    parts.push(section("Acceptance Criteria", bullet(data.acceptance_criteria.map((c) => c?.text || ""))));
-  }
-
-  if (data.escalation_rules?.length) {
-    const rules = data.escalation_rules
-      .filter((r) => r.trigger || r.escalateTo)
-      .map((r) => `- [${r.priority || "P2"}] ${r.trigger || "(unspecified trigger)"} → ${r.escalateTo || "(unspecified)"}`)
-      .join("\n");
-    if (rules) parts.push(section("Escalation", rules));
-  }
-
-  if (data.rollback_procedure) parts.push(section("Rollback", data.rollback_procedure));
-  if (data.notes) parts.push(section("Notes", data.notes));
-
-  return joinSections(parts);
-}
-
-export function renderFrameworkMarkdown(input: string | FrameworkData | null | undefined): string {
-  if (input == null) return "";
-  const data: FrameworkData = typeof input === "string"
-    ? (safeParse<FrameworkData>(input) || {})
-    : input;
-
-  const parts: string[] = [];
-  if (data.mission) parts.push(section("Mission", data.mission));
-  if (data.vision) parts.push(section("Vision", data.vision));
-  if (data.core_principles?.length) parts.push(section("Core Principles", bullet(data.core_principles)));
-
-  const authParts: string[] = [];
-  if (data.decision_authority) authParts.push(`**Decision authority:** ${data.decision_authority}`);
-  if (data.budget_constraints) authParts.push(`**Budget constraints:** ${data.budget_constraints}`);
-  if (data.resource_limits) authParts.push(`**Resource limits:** ${data.resource_limits}`);
-  if (data.tool_stack?.length) authParts.push(`**Tool stack:**\n${bullet(data.tool_stack)}`);
-  if (authParts.length) parts.push(section("Authority & Constraints", authParts.join("\n\n")));
-
-  if (data.strategic_objectives?.length) {
-    const rows = data.strategic_objectives
-      .filter((o) => o.objective || o.target)
-      .map((o) => {
-        const bits = [
-          o.objective ? `**${o.objective}**` : "",
-          o.target ? `target: ${o.target}` : "",
-          o.measurement ? `measure: ${o.measurement}` : "",
-          o.frequency ? `cadence: ${o.frequency}` : "",
-        ].filter(Boolean);
-        return `- ${bits.join(" · ")}`;
-      })
-      .join("\n");
-    if (rows) parts.push(section("Strategic Objectives (KPIs)", rows));
-  }
-
-  const riskParts: string[] = [];
-  if (data.risk_appetite) riskParts.push(`**Risk appetite:** ${data.risk_appetite}`);
-  if (data.compliance_requirements?.length) riskParts.push(`**Compliance:**\n${bullet(data.compliance_requirements)}`);
-  if (riskParts.length) parts.push(section("Risk & Compliance", riskParts.join("\n\n")));
-
-  if (data.escalation_matrix?.length) {
-    const rows = data.escalation_matrix
-      .filter((e) => e.trigger || e.escalate_to)
-      .map((e) => {
-        const sla = e.response_sla ? ` (SLA ${e.response_sla})` : "";
-        return `- [${e.priority || "P2"}] ${e.trigger || "(unspecified)"} → ${e.escalate_to || "(unspecified)"}${sla}`;
-      })
-      .join("\n");
-    if (rows) parts.push(section("Escalation Matrix", rows));
-  }
-
-  const teamParts: string[] = [];
-  if (data.team_composition) teamParts.push(`**Team:** ${data.team_composition}`);
-  if (data.integration_points?.length) teamParts.push(`**Integration points:**\n${bullet(data.integration_points)}`);
-  if (teamParts.length) parts.push(section("Team & Integrations", teamParts.join("\n\n")));
-
-  if (data.review_frequency || data.next_review) {
-    const lines = [
-      data.review_frequency ? `**Review cadence:** ${data.review_frequency}` : "",
-      data.last_reviewed ? `**Last reviewed:** ${data.last_reviewed}` : "",
-      data.next_review ? `**Next review:** ${data.next_review}` : "",
-    ].filter(Boolean);
-    if (lines.length) parts.push(section("Review Cycle", lines.join("\n")));
-  }
-
-  if (data.notes) parts.push(section("Notes", data.notes));
-
-  return joinSections(parts);
-}
-
-export function renderAttachmentBlock(args: {
-  sops?: Array<{ title: string; content: string }>;
-  frameworks?: Array<{ title: string; content: string }>;
-}): string {
-  const blocks: string[] = [];
-
-  if (args.frameworks?.length) {
-    const sections = args.frameworks.map((fw) => {
-      const md = renderFrameworkMarkdown(fw.content);
-      if (!md) return `## ${fw.title}\n_(empty)_`;
-      return `## ${fw.title}\n${md}`;
-    }).join("\n\n");
-    blocks.push(`[FRAMEWORKS — ATTACHED]\nThese frameworks are active for this run. Orient strategic decisions toward them.\n\n${sections}`);
-  }
-
-  if (args.sops?.length) {
-    const sections = args.sops.map((sop) => {
-      const md = renderSopMarkdown(sop.content);
-      if (!md) return `## ${sop.title}\n_(empty)_`;
-      return `## ${sop.title}\n${md}`;
-    }).join("\n\n");
-    blocks.push(`[SOPS — ATTACHED]\nThese SOPs are active for this run. Follow the procedure steps and escalation rules.\n\n${sections}`);
-  }
-
-  return blocks.join("\n\n");
-}
+// src/sop-render.ts — Plugin-side markdown renderer for SOPs and Frameworks.
+// Mirrors dashboard/lib/sopRender.ts. Output is what gets prepended/appended to
+// the system prompt during `before_prompt_build`.
+
+interface SOPCheckItem { text?: string; checked?: boolean; }
+interface SOPStep {
+  name?: string; action?: string; owner?: string; output?: string;
+  decision_logic?: string; failure_state?: string; fallback_action?: string;
+  estimated_duration?: string;
+}
+interface SOPEscalationRule { trigger?: string; escalateTo?: string; priority?: string; }
+interface SOPPrerequisites {
+  conditions?: SOPCheckItem[]; required_tools?: string[];
+  required_permissions?: string[]; safety_warnings?: string[];
+}
+export interface SOPData {
+  title?: string;
+  purpose?: string; scope?: string; applicability?: string;
+  prerequisites?: SOPPrerequisites;
+  procedure_steps?: SOPStep[];
+  expected_outputs?: string[];
+  acceptance_criteria?: SOPCheckItem[];
+  escalation_rules?: SOPEscalationRule[];
+  rollback_procedure?: string;
+  notes?: string;
+}
+
+interface FrameworkObjective {
+  objective?: string; target?: string; measurement?: string; frequency?: string;
+}
+interface FrameworkEscalation {
+  trigger?: string; escalate_to?: string; priority?: string; response_sla?: string;
+}
+export interface FrameworkData {
+  title?: string;
+  mission?: string; vision?: string;
+  core_principles?: string[];
+  decision_authority?: string; budget_constraints?: string;
+  resource_limits?: string; tool_stack?: string[];
+  strategic_objectives?: FrameworkObjective[];
+  risk_appetite?: string; compliance_requirements?: string[];
+  escalation_matrix?: FrameworkEscalation[];
+  team_composition?: string; integration_points?: string[];
+  review_frequency?: string; last_reviewed?: string; next_review?: string;
+  notes?: string;
+}
+
+function bullet(items: (string | undefined | null)[]): string {
+  const cleaned = items.map((s) => (s ?? "").toString().trim()).filter(Boolean);
+  return cleaned.length ? cleaned.map((s) => `- ${s}`).join("\n") : "";
+}
+
+function section(label: string, body: string): string {
+  const trimmed = body.trim();
+  return trimmed ? `### ${label}\n${trimmed}` : "";
+}
+
+function joinSections(parts: string[]): string {
+  return parts.filter(Boolean).join("\n\n");
+}
+
+function safeParse<T = unknown>(s: string): T | null {
+  try { return JSON.parse(s) as T; } catch { return null; }
+}
+
+export function renderSopMarkdown(input: string | SOPData | null | undefined): string {
+  if (input == null) return "";
+  const data: SOPData = typeof input === "string"
+    ? (safeParse<SOPData>(input) || {})
+    : input;
+
+  const parts: string[] = [];
+  if (data.purpose) parts.push(section("Purpose", data.purpose));
+  if (data.scope) parts.push(section("Scope", data.scope));
+  if (data.applicability) parts.push(section("Applicability", data.applicability));
+
+  const prereq = data.prerequisites;
+  if (prereq) {
+    const pieces: string[] = [];
+    const cond = (prereq.conditions || []).map((c) => c?.text).filter(Boolean) as string[];
+    if (cond.length) pieces.push(`**Conditions:**\n${bullet(cond)}`);
+    if (prereq.required_tools?.length) pieces.push(`**Required tools:**\n${bullet(prereq.required_tools)}`);
+    if (prereq.required_permissions?.length) pieces.push(`**Required permissions:**\n${bullet(prereq.required_permissions)}`);
+    if (prereq.safety_warnings?.length) pieces.push(`**Safety warnings:**\n${bullet(prereq.safety_warnings)}`);
+    if (pieces.length) parts.push(section("Prerequisites", pieces.join("\n\n")));
+  }
+
+  if (data.procedure_steps?.length) {
+    const steps = data.procedure_steps.map((step, i) => {
+      const lines: string[] = [`${i + 1}. **${step.name || `Step ${i + 1}`}**`];
+      if (step.action) lines.push(`   - Action: ${step.action}`);
+      if (step.owner) lines.push(`   - Owner: ${step.owner}`);
+      if (step.output) lines.push(`   - Output: ${step.output}`);
+      if (step.decision_logic) lines.push(`   - Decision logic: ${step.decision_logic}`);
+      if (step.failure_state) lines.push(`   - Failure state: ${step.failure_state}`);
+      if (step.fallback_action) lines.push(`   - Fallback: ${step.fallback_action}`);
+      if (step.estimated_duration) lines.push(`   - ETA: ${step.estimated_duration}`);
+      return lines.join("\n");
+    }).join("\n");
+    parts.push(section("Procedure", steps));
+  }
+
+  if (data.expected_outputs?.length) parts.push(section("Expected Outputs", bullet(data.expected_outputs)));
+  if (data.acceptance_criteria?.length) {
+    parts.push(section("Acceptance Criteria", bullet(data.acceptance_criteria.map((c) => c?.text || ""))));
+  }
+
+  if (data.escalation_rules?.length) {
+    const rules = data.escalation_rules
+      .filter((r) => r.trigger || r.escalateTo)
+      .map((r) => `- [${r.priority || "P2"}] ${r.trigger || "(unspecified trigger)"} → ${r.escalateTo || "(unspecified)"}`)
+      .join("\n");
+    if (rules) parts.push(section("Escalation", rules));
+  }
+
+  if (data.rollback_procedure) parts.push(section("Rollback", data.rollback_procedure));
+  if (data.notes) parts.push(section("Notes", data.notes));
+
+  return joinSections(parts);
+}
+
+export function renderFrameworkMarkdown(input: string | FrameworkData | null | undefined): string {
+  if (input == null) return "";
+  const data: FrameworkData = typeof input === "string"
+    ? (safeParse<FrameworkData>(input) || {})
+    : input;
+
+  const parts: string[] = [];
+  if (data.mission) parts.push(section("Mission", data.mission));
+  if (data.vision) parts.push(section("Vision", data.vision));
+  if (data.core_principles?.length) parts.push(section("Core Principles", bullet(data.core_principles)));
+
+  const authParts: string[] = [];
+  if (data.decision_authority) authParts.push(`**Decision authority:** ${data.decision_authority}`);
+  if (data.budget_constraints) authParts.push(`**Budget constraints:** ${data.budget_constraints}`);
+  if (data.resource_limits) authParts.push(`**Resource limits:** ${data.resource_limits}`);
+  if (data.tool_stack?.length) authParts.push(`**Tool stack:**\n${bullet(data.tool_stack)}`);
+  if (authParts.length) parts.push(section("Authority & Constraints", authParts.join("\n\n")));
+
+  if (data.strategic_objectives?.length) {
+    const rows = data.strategic_objectives
+      .filter((o) => o.objective || o.target)
+      .map((o) => {
+        const bits = [
+          o.objective ? `**${o.objective}**` : "",
+          o.target ? `target: ${o.target}` : "",
+          o.measurement ? `measure: ${o.measurement}` : "",
+          o.frequency ? `cadence: ${o.frequency}` : "",
+        ].filter(Boolean);
+        return `- ${bits.join(" · ")}`;
+      })
+      .join("\n");
+    if (rows) parts.push(section("Strategic Objectives (KPIs)", rows));
+  }
+
+  const riskParts: string[] = [];
+  if (data.risk_appetite) riskParts.push(`**Risk appetite:** ${data.risk_appetite}`);
+  if (data.compliance_requirements?.length) riskParts.push(`**Compliance:**\n${bullet(data.compliance_requirements)}`);
+  if (riskParts.length) parts.push(section("Risk & Compliance", riskParts.join("\n\n")));
+
+  if (data.escalation_matrix?.length) {
+    const rows = data.escalation_matrix
+      .filter((e) => e.trigger || e.escalate_to)
+      .map((e) => {
+        const sla = e.response_sla ? ` (SLA ${e.response_sla})` : "";
+        return `- [${e.priority || "P2"}] ${e.trigger || "(unspecified)"} → ${e.escalate_to || "(unspecified)"}${sla}`;
+      })
+      .join("\n");
+    if (rows) parts.push(section("Escalation Matrix", rows));
+  }
+
+  const teamParts: string[] = [];
+  if (data.team_composition) teamParts.push(`**Team:** ${data.team_composition}`);
+  if (data.integration_points?.length) teamParts.push(`**Integration points:**\n${bullet(data.integration_points)}`);
+  if (teamParts.length) parts.push(section("Team & Integrations", teamParts.join("\n\n")));
+
+  if (data.review_frequency || data.next_review) {
+    const lines = [
+      data.review_frequency ? `**Review cadence:** ${data.review_frequency}` : "",
+      data.last_reviewed ? `**Last reviewed:** ${data.last_reviewed}` : "",
+      data.next_review ? `**Next review:** ${data.next_review}` : "",
+    ].filter(Boolean);
+    if (lines.length) parts.push(section("Review Cycle", lines.join("\n")));
+  }
+
+  if (data.notes) parts.push(section("Notes", data.notes));
+
+  return joinSections(parts);
+}
+
+export function renderAttachmentBlock(args: {
+  sops?: Array<{ title: string; content: string }>;
+  frameworks?: Array<{ title: string; content: string }>;
+}): string {
+  const blocks: string[] = [];
+
+  if (args.frameworks?.length) {
+    const sections = args.frameworks.map((fw) => {
+      const md = renderFrameworkMarkdown(fw.content);
+      if (!md) return `## ${fw.title}\n_(empty)_`;
+      return `## ${fw.title}\n${md}`;
+    }).join("\n\n");
+    blocks.push(`[FRAMEWORKS — ATTACHED]\nThese frameworks are active for this run. Orient strategic decisions toward them.\n\n${sections}`);
+  }
+
+  if (args.sops?.length) {
+    const sections = args.sops.map((sop) => {
+      const md = renderSopMarkdown(sop.content);
+      if (!md) return `## ${sop.title}\n_(empty)_`;
+      return `## ${sop.title}\n${md}`;
+    }).join("\n\n");
+    blocks.push(`[SOPS — ATTACHED]\nThese SOPs are active for this run. Follow the procedure steps and escalation rules.\n\n${sections}`);
+  }
+
+  return blocks.join("\n\n");
+}