@cotrrackpro-dev/sdk 0.1.0

package/dist/diagram/extract.js

@@ -0,0 +1,213 @@
+const MAX_ITEMS = 100;
+function clean(label) {
+    return label.replace(/["[\]{}|]/g, "'").replace(/\s+/g, " ").trim().slice(0, 90) || "step";
+}
+/** Drop leading connector words so "then notify" reads as "notify". */
+function stripConnector(s) {
+    return s.replace(/^(then|next|afterwards?|after that|finally|so)[\s,:;-]+/i, "").trim();
+}
+/** Split a document into ordered items, preserving each numbered step's written ordinal. */
+function splitItems(text) {
+    const lines = text.split(/\r?\n/).map((l) => l.trim());
+    const markered = [];
+    for (const l of lines) {
+        const numbered = l.match(/^(\d+)[.)]\s+(.*)$/);
+        if (numbered) {
+            markered.push({ text: (numbered[2] ?? "").trim(), num: Number(numbered[1]) });
+            continue;
+        }
+        const bullet = l.match(/^[-*•]\s+(.*)$/);
+        if (bullet)
+            markered.push({ text: (bullet[1] ?? "").trim(), num: null });
+    }
+    const items = markered.length > 0 ? markered : lines.filter((l) => l.length > 0 && !/^#{1,6}\s/.test(l)).map((t) => ({ text: t, num: null }));
+    return items.map((it) => ({ text: stripConnector(it.text), num: it.num })).filter((it) => it.text).slice(0, MAX_ITEMS);
+}
+/** A "go to / return to / repeat (step) N" loop instruction → the target step number, else null. */
+function parseGoto(text) {
+    const m = text.match(/^(?:go\s*(?:back\s*)?to|goto|return\s+to|back\s+to|repeat|loop\s+back\s+to)\s+(?:step\s+)?(\d+)\b/i);
+    return m ? Number(m[1]) : null;
+}
+function classify(raw) {
+    if (/^(end|done|stop|finish|exit|complete)\b/i.test(raw) || /\b(escalate|call 911|dial 988|terminate)\b/i.test(raw)) {
+        return "terminal";
+    }
+    if (/\?\s*$/.test(raw) || /^(is|are|does|do|should|can|could|has|have|will|did|may|was|were)\b/i.test(raw)) {
+        return "decision";
+    }
+    return "process";
+}
+// A list item that is a branch of the preceding decision: "Yes: do X", "No — stop", "Otherwise …".
+const BRANCH_RE = /^(yes|no|if yes|if not|if no|otherwise|else)\b[\s:.)\-—]*(.*)$/i;
+function branchLabel(word) {
+    const w = word.toLowerCase();
+    if (w.startsWith("y"))
+        return "Yes";
+    if (w === "no" || w === "if no" || w === "if not")
+        return "No";
+    return "Otherwise";
+}
+/** Extract a flowchart from free-ish text (steps, if/then/else, and decision branches). */
+export function extractFromText(text, opts = {}) {
+    const nodes = [];
+    const edges = [];
+    let counter = 0;
+    const add = (label, shape) => {
+        const id = `n${++counter}`;
+        nodes.push({ id, label: clean(label), shape });
+        return id;
+    };
+    const connect = (froms, to, label) => {
+        for (const f of froms)
+            edges.push(label ? { from: f, to, label } : { from: f, to });
+    };
+    const items = splitItems(text);
+    let prevExits = [add("Start", "terminal")];
+    // Map each written step number → the entry node it produced, so "go to step N"
+    // can loop back. Forward references (N defined later) are deferred and resolved
+    // after the full pass, keeping the result deterministic regardless of direction.
+    const stepNodes = new Map();
+    const recordStep = (num, id) => {
+        if (num !== null && !stepNodes.has(num))
+            stepNodes.set(num, id);
+    };
+    const pendingGotos = [];
+    const resolveGoto = (froms, target, label) => {
+        if (froms.length === 0)
+            return;
+        const to = stepNodes.get(target);
+        if (to)
+            connect(froms, to, label);
+        else
+            pendingGotos.push({ froms, target, label });
+    };
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const raw = item.text;
+        // Loop instruction: "go to / return to / repeat step N" — a back-edge, not a new node.
+        const standaloneGoto = parseGoto(raw);
+        if (standaloneGoto !== null) {
+            resolveGoto(prevExits, standaloneGoto, "repeat");
+            prevExits = []; // the path loops; it doesn't fall through
+            continue;
+        }
+        // Single-line "if X then Y [else Z]" — Y/Z may themselves be "go to step N" loops.
+        const ifm = raw.match(/^if\s+(.+?)\s+then\s+(.+?)(?:[,;]?\s+(?:else|otherwise)\s+(.+))?$/i);
+        if (ifm) {
+            const decision = add(`${(ifm[1] ?? "").replace(/\?+$/, "")}?`, "decision");
+            connect(prevExits, decision);
+            recordStep(item.num, decision);
+            const exits = [];
+            const branch = (body, label) => {
+                if (!body)
+                    return;
+                const goto = parseGoto(body);
+                if (goto !== null) {
+                    resolveGoto([decision], goto, label); // branch loops back; adds no exit
+                    return;
+                }
+                const node = add(body, "process");
+                edges.push({ from: decision, to: node, label });
+                exits.push(node);
+            };
+            branch(ifm[2], "Yes");
+            if (ifm[3])
+                branch(ifm[3], "No");
+            else
+                exits.push(decision); // no else → the decision's "No" path falls through
+            prevExits = exits;
+            continue;
+        }
+        const kind = classify(raw);
+        if (kind === "decision") {
+            const decision = add(raw, "decision");
+            connect(prevExits, decision);
+            recordStep(item.num, decision);
+            // Absorb any immediately-following "Yes/No/Otherwise …" items as labeled branches.
+            const branchExits = [];
+            let consumed = 0;
+            let hadGotoBranch = false;
+            let j = i + 1;
+            while (j < items.length) {
+                const bm = items[j].text.match(BRANCH_RE);
+                if (!bm)
+                    break;
+                const label = branchLabel(bm[1] ?? "");
+                const txt = (bm[2] ?? "").trim() || label;
+                const goto = parseGoto(txt);
+                if (goto !== null) {
+                    resolveGoto([decision], goto, label); // branch loops back; adds no exit
+                    hadGotoBranch = true;
+                }
+                else {
+                    const isTerminal = classify(txt) === "terminal";
+                    const node = add(txt, isTerminal ? "terminal" : "process");
+                    edges.push({ from: decision, to: node, label });
+                    if (!isTerminal)
+                        branchExits.push(node);
+                }
+                consumed++;
+                j++;
+            }
+            // When a branch loops back (or all branches terminate), the decision itself stays an
+            // exit so the implicit complementary path falls through to the next step.
+            if (hadGotoBranch && !branchExits.includes(decision))
+                branchExits.push(decision);
+            prevExits = consumed > 0 && branchExits.length > 0 ? branchExits : [decision];
+            i += consumed;
+            continue;
+        }
+        if (kind === "terminal") {
+            const t = add(raw, "terminal");
+            connect(prevExits, t);
+            recordStep(item.num, t);
+            prevExits = []; // this path ends here
+            continue;
+        }
+        const node = add(raw, "process");
+        connect(prevExits, node);
+        recordStep(item.num, node);
+        prevExits = [node];
+    }
+    // Resolve forward "go to step N" references now that every step node exists.
+    for (const g of pendingGotos) {
+        const to = stepNodes.get(g.target);
+        if (to)
+            connect(g.froms, to, g.label);
+    }
+    if (prevExits.length > 0) {
+        const end = add("End", "terminal");
+        connect(prevExits, end);
+    }
+    return { title: opts.title, direction: opts.direction ?? "TD", nodes, edges };
+}
+/** Extract a data-collection flowchart from a parameter set (the builder logic). */
+export function extractFromParamSet(set, opts = {}) {
+    const nodes = [];
+    const edges = [];
+    let counter = 0;
+    const add = (label, shape) => {
+        const id = `n${++counter}`;
+        nodes.push({ id, label: clean(label), shape });
+        return id;
+    };
+    const start = add("Start", "terminal");
+    let prev = add(`Open "${set.title}"`, "process");
+    edges.push({ from: start, to: prev });
+    for (const f of set.fields) {
+        const node = add(`Collect ${f.label}${f.required ? " (required)" : ""}`, "io");
+        edges.push({ from: prev, to: node });
+        prev = node;
+    }
+    const validate = add("All required fields valid?", "decision");
+    edges.push({ from: prev, to: validate });
+    const fix = add("Fix inputs", "process");
+    edges.push({ from: validate, to: fix, label: "No" });
+    edges.push({ from: fix, to: validate });
+    const approve = add("Review & approve", "process");
+    edges.push({ from: validate, to: approve, label: "Yes" });
+    const end = add("End", "terminal");
+    edges.push({ from: approve, to: end });
+    return { title: set.title, direction: opts.direction ?? "TD", nodes, edges };
+}
+//# sourceMappingURL=extract.js.map

package/dist/diagram/extract.js.map

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

package/dist/diagram/index.d.ts

@@ -0,0 +1,2 @@
+/** Diagram engine: extract logic, render Mermaid, validate, and approve. */
+export * from "./core.js";

package/dist/diagram/index.js

@@ -0,0 +1,3 @@
+/** Diagram engine: extract logic, render Mermaid, validate, and approve. */
+export * from "./core.js";
+//# sourceMappingURL=index.js.map

package/dist/diagram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diagram/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,WAAW,CAAC"}

package/dist/diagram/mermaid.d.ts

@@ -0,0 +1,10 @@
+/** Render a Diagram to Mermaid, and to an approval-ready markdown document. */
+import type { ApprovalMeta, Diagram } from "./types.js";
+/** A Mermaid `flowchart` for the diagram. */
+export declare function toMermaid(d: Diagram): string;
+/**
+ * An approval-ready markdown document: the diagram plus a sign-off block. This
+ * is the artifact a human reviews BEFORE any solution is built or deployed.
+ * Set the status to `Approved` once signed off (the scaffold gate looks for it).
+ */
+export declare function toMarkdown(d: Diagram, meta?: ApprovalMeta): string;

package/dist/diagram/mermaid.js

@@ -0,0 +1,50 @@
+function label(text) {
+    return text.replace(/"/g, "'").replace(/\s+/g, " ").trim();
+}
+function nodeLine(n) {
+    const l = `"${label(n.label)}"`;
+    switch (n.shape) {
+        case "decision": return `  ${n.id}{${l}}`;
+        case "terminal": return `  ${n.id}([${l}])`;
+        case "io": return `  ${n.id}[/${l}/]`;
+        default: return `  ${n.id}[${l}]`;
+    }
+}
+/** A Mermaid `flowchart` for the diagram. */
+export function toMermaid(d) {
+    const lines = [`flowchart ${d.direction}`];
+    for (const n of d.nodes)
+        lines.push(nodeLine(n));
+    for (const e of d.edges) {
+        lines.push(e.label ? `  ${e.from} -->|${label(e.label)}| ${e.to}` : `  ${e.from} --> ${e.to}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * An approval-ready markdown document: the diagram plus a sign-off block. This
+ * is the artifact a human reviews BEFORE any solution is built or deployed.
+ * Set the status to `Approved` once signed off (the scaffold gate looks for it).
+ */
+export function toMarkdown(d, meta = {}) {
+    const title = d.title ? `# ${label(d.title)} — logic` : "# Process logic";
+    return [
+        title,
+        "",
+        "> **Visualize & approve.** Review this logic before any solution is built or deployed.",
+        "> Educational and informational only — not legal or clinical advice.",
+        "",
+        "```mermaid",
+        toMermaid(d),
+        "```",
+        "",
+        "## Approval",
+        "",
+        `- **Source:** ${meta.source ?? "—"}`,
+        `- **Data sensitivity:** ${meta.dataSensitivity ?? "—"}`,
+        `- **Prepared by:** ${meta.preparedBy ?? "____________"}`,
+        "- **Approved by:** ____________  **Date:** __________",
+        "- **Status:** Draft  ·  _change to `Approved` once signed off_",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/diagram/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/diagram/mermaid.ts"],"names":[],"mappings":"AAGA,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,CAAc;IAC9B,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;IAChC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC;QAC1C,KAAK,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;QAC5C,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC;IACpC,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,SAAS,CAAC,CAAU;IAClC,MAAM,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,OAAqB,EAAE;IAC5D,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC1E,OAAO;QACL,KAAK;QACL,EAAE;QACF,wFAAwF;QACxF,sEAAsE;QACtE,EAAE;QACF,YAAY;QACZ,SAAS,CAAC,CAAC,CAAC;QACZ,KAAK;QACL,EAAE;QACF,aAAa;QACb,EAAE;QACF,iBAAiB,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE;QACrC,2BAA2B,IAAI,CAAC,eAAe,IAAI,GAAG,EAAE;QACxD,sBAAsB,IAAI,CAAC,UAAU,IAAI,cAAc,EAAE;QACzD,uDAAuD;QACvD,gEAAgE;QAChE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/diagram/prompt.d.ts

@@ -0,0 +1,4 @@
+/** Turn a diagram into a plain-English prompt to paste into any AI assistant. */
+import type { Diagram } from "./types.js";
+/** A ready-to-paste prompt asking an assistant to review the process logic. */
+export declare function toPrompt(d: Diagram): string;

package/dist/diagram/prompt.js

@@ -0,0 +1,16 @@
+import { toMermaid } from "./mermaid.js";
+/** A ready-to-paste prompt asking an assistant to review the process logic. */
+export function toPrompt(d) {
+    return [
+        `Here's a process I'm mapping out${d.title ? ` for "${d.title}"` : ""}, drawn as a flowchart:`,
+        "",
+        "```mermaid",
+        toMermaid(d),
+        "```",
+        "",
+        "Please review the logic in plain language: are the steps in a sensible order, are the decision points (the diamonds) right, and is anything missing, unclear, or unsafe? Suggest specific improvements.",
+        "",
+        "Keep it educational and informational only — not legal or clinical advice. Use court-neutral, child-centered language. If anything is urgent, lead with crisis resources first (988, or text HOME to 741741).",
+    ].join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/diagram/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/diagram/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,OAAO;QACL,mCAAmC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,yBAAyB;QAC9F,EAAE;QACF,YAAY;QACZ,SAAS,CAAC,CAAC,CAAC;QACZ,KAAK;QACL,EAAE;QACF,yMAAyM;QACzM,EAAE;QACF,+MAA+M;KAChN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/diagram/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Diagram model: a small, Mermaid-flavored flowchart used by the
+ * "visualize & approve" stage. Import-free (no node:/external deps) so the
+ * compiled output runs in the browser builder and the CLI alike.
+ */
+export type NodeShape = "process" | "decision" | "terminal" | "io";
+export interface DiagramNode {
+    id: string;
+    label: string;
+    shape: NodeShape;
+}
+export interface DiagramEdge {
+    from: string;
+    to: string;
+    label?: string;
+}
+export type Direction = "TD" | "LR";
+export interface Diagram {
+    title?: string;
+    direction: Direction;
+    nodes: DiagramNode[];
+    edges: DiagramEdge[];
+}
+/** Sign-off metadata rendered into the approval document. */
+export interface ApprovalMeta {
+    source?: string;
+    preparedBy?: string;
+    dataSensitivity?: "public" | "sensitive" | "confidential";
+}
+export interface DiagramValidation {
+    valid: boolean;
+    errors: string[];
+}

package/dist/diagram/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diagram/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/diagram/types.ts"],"names":[],"mappings":""}

package/dist/diagram/validate.d.ts

@@ -0,0 +1,13 @@
+/** Lightweight, dependency-free validation for diagrams and Mermaid source. */
+import type { Diagram, DiagramValidation } from "./types.js";
+/** Structural checks on a Diagram: ids unique, edges reference real nodes. */
+export declare function validateDiagram(d: Diagram): DiagramValidation;
+/**
+ * Sanity-check Mermaid flowchart source (not a full parser): it must declare a
+ * flowchart/graph and contain at least one node or edge. Good enough to catch
+ * an empty or obviously-broken block before approval; the portal preview and
+ * the Mermaid renderer do the full parse.
+ */
+export declare function validateMermaid(src: string): DiagramValidation;
+/** Extract the first ```mermaid fenced block from a markdown document. */
+export declare function extractMermaidBlock(markdown: string): string | null;

package/dist/diagram/validate.js

@@ -0,0 +1,48 @@
+/** Structural checks on a Diagram: ids unique, edges reference real nodes. */
+export function validateDiagram(d) {
+    const errors = [];
+    if (d.nodes.length === 0)
+        errors.push("diagram has no nodes");
+    const ids = new Set();
+    for (const n of d.nodes) {
+        if (ids.has(n.id))
+            errors.push(`duplicate node id: ${n.id}`);
+        ids.add(n.id);
+        if (!n.label.trim())
+            errors.push(`node ${n.id} has an empty label`);
+    }
+    for (const e of d.edges) {
+        if (!ids.has(e.from))
+            errors.push(`edge references unknown node: ${e.from}`);
+        if (!ids.has(e.to))
+            errors.push(`edge references unknown node: ${e.to}`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Sanity-check Mermaid flowchart source (not a full parser): it must declare a
+ * flowchart/graph and contain at least one node or edge. Good enough to catch
+ * an empty or obviously-broken block before approval; the portal preview and
+ * the Mermaid renderer do the full parse.
+ */
+export function validateMermaid(src) {
+    const errors = [];
+    const trimmed = src.trim();
+    if (!trimmed) {
+        return { valid: false, errors: ["empty diagram"] };
+    }
+    if (!/^(flowchart|graph)\s+(TD|TB|LR|RL|BT)\b/m.test(trimmed)) {
+        errors.push("missing `flowchart <DIR>` (or `graph <DIR>`) header");
+    }
+    const body = trimmed.split(/\r?\n/).slice(1).filter((l) => l.trim());
+    if (body.length === 0)
+        errors.push("diagram has no nodes or edges");
+    return { valid: errors.length === 0, errors };
+}
+/** Extract the first ```mermaid fenced block from a markdown document. */
+export function extractMermaidBlock(markdown) {
+    const m = markdown.match(/```mermaid\s*\n([\s\S]*?)```/i);
+    const block = m?.[1];
+    return block !== undefined ? block.trim() : null;
+}
+//# sourceMappingURL=validate.js.map

package/dist/diagram/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/diagram/validate.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACd,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACpE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/dist/guide/compose.d.ts

@@ -0,0 +1,10 @@
+/** Deterministic building blocks shared by the renderer and the diagram embed. */
+import type { GuideInput } from "./types.js";
+/**
+ * The onboarding checklist for a new user — derived deterministically from the
+ * source. These double as the nodes of the embedded flow diagram, so the
+ * picture and the checklist never disagree.
+ */
+export declare function onboardingSteps(input: GuideInput): string[];
+/** The standard feedback prompts every guide asks for — structured, comparable. */
+export declare const FEEDBACK_QUESTIONS: string[];

package/dist/guide/compose.js

@@ -0,0 +1,31 @@
+/**
+ * The onboarding checklist for a new user — derived deterministically from the
+ * source. These double as the nodes of the embedded flow diagram, so the
+ * picture and the checklist never disagree.
+ */
+export function onboardingSteps(input) {
+    const steps = [];
+    steps.push("Confirm access — assign each teammate the right role and tier");
+    steps.push("Install and sign in: run cotrackpro setup");
+    if (input.scaffold)
+        steps.push(`Scaffold the module: ${input.scaffold}`);
+    for (const s of input.scenarios ?? []) {
+        steps.push(`Walk the "${s.title}" scenario end to end${s.steps ? ` (${s.steps} steps)` : ""}`);
+    }
+    const firstArtifact = (input.artifacts ?? [])[0];
+    if (firstArtifact)
+        steps.push(`Produce a first artifact: ${firstArtifact.title}`);
+    if ((input.guardrails ?? []).length)
+        steps.push("Review the guardrails before anything is shared");
+    steps.push("Collect feedback from the first cohort");
+    return steps;
+}
+/** The standard feedback prompts every guide asks for — structured, comparable. */
+export const FEEDBACK_QUESTIONS = [
+    "Overall, how ready did you feel after onboarding? (1–5)",
+    "What was clear and worked well?",
+    "Where did you get stuck or confused?",
+    "What one change would have helped most?",
+    "Anything unsafe, unclear, or out of date you noticed?",
+];
+//# sourceMappingURL=compose.js.map

package/dist/guide/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/guide/compose.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,wBAAwB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,aAAa,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,6BAA6B,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACnG,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,yDAAyD;IACzD,iCAAiC;IACjC,sCAAsC;IACtC,yCAAyC;IACzC,uDAAuD;CACxD,CAAC"}

package/dist/guide/core.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Browser-safe barrel for the guide engine. Import-free by construction so the
+ * compiled output loads directly in the portal builder — the CLI and the portal
+ * share the exact compose/render logic. Keep it that way (an SDK test enforces
+ * no external imports).
+ */
+export * from "./types.js";
+export * from "./compose.js";
+export * from "./render.js";
+export * from "./prompt.js";

package/dist/guide/core.js

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe barrel for the guide engine. Import-free by construction so the
+ * compiled output loads directly in the portal builder — the CLI and the portal
+ * share the exact compose/render logic. Keep it that way (an SDK test enforces
+ * no external imports).
+ */
+export * from "./types.js";
+export * from "./compose.js";
+export * from "./render.js";
+export * from "./prompt.js";
+//# sourceMappingURL=core.js.map

package/dist/guide/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/guide/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/guide/index.d.ts

@@ -0,0 +1,2 @@
+/** Guide engine: compose operational onboarding + feedback playbooks from the catalog. */
+export * from "./core.js";

package/dist/guide/index.js

@@ -0,0 +1,3 @@
+/** Guide engine: compose operational onboarding + feedback playbooks from the catalog. */
+export * from "./core.js";
+//# sourceMappingURL=index.js.map

package/dist/guide/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guide/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,cAAc,WAAW,CAAC"}

package/dist/guide/prompt.d.ts

@@ -0,0 +1,8 @@
+/** Turn a guide source into a plain-English prompt to paste into any AI assistant. */
+import type { GuideInput } from "./types.js";
+/**
+ * A ready-to-paste prompt for someone who doesn't know how to prompt: it explains
+ * what they're building and asks the assistant for help, with the platform's
+ * safety framing baked in so the response stays court-neutral and educational.
+ */
+export declare function toPrompt(input: GuideInput): string;

package/dist/guide/prompt.js

@@ -0,0 +1,20 @@
+import { onboardingSteps } from "./compose.js";
+/**
+ * A ready-to-paste prompt for someone who doesn't know how to prompt: it explains
+ * what they're building and asks the assistant for help, with the platform's
+ * safety framing baked in so the response stays court-neutral and educational.
+ */
+export function toPrompt(input) {
+    const steps = onboardingSteps(input).map((s, i) => `${i + 1}. ${s}`).join("\n");
+    return [
+        `I'm setting up "${input.title}" and need help onboarding a new person to it.`,
+        "",
+        "Here's the plan I have so far:",
+        steps,
+        "",
+        "Please turn this into a clear, friendly onboarding guide, point out anything I'm missing, and suggest a simple way to gather feedback from the first people who use it.",
+        "",
+        "Keep everything educational and informational only — not legal or clinical advice. Use court-neutral, child-centered language: describe behavior, use a child's initials, and never characterize a parent. If anything is urgent, lead with crisis resources first (988, or text HOME to 741741).",
+    ].join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/guide/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/guide/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,OAAO;QACL,mBAAmB,KAAK,CAAC,KAAK,gDAAgD;QAC9E,EAAE;QACF,gCAAgC;QAChC,KAAK;QACL,EAAE;QACF,yKAAyK;QACzK,EAAE;QACF,mSAAmS;KACpS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/guide/render.d.ts

@@ -0,0 +1,9 @@
+/** Render a GuideInput into an operational, dual-audience markdown playbook. */
+import type { GuideInput, GuideOptions } from "./types.js";
+/**
+ * Compose the full guide. Audience controls emphasis:
+ *  - "dev"    → commands, scaffolding, SDK wiring
+ *  - "leader" → rollout, access, adoption, feedback cadence
+ *  - "both"   → both, as labeled callouts (default)
+ */
+export declare function toMarkdown(input: GuideInput, opts?: GuideOptions): string;