@medicine-wheel/mcp 4.0.0

package/dist/tools/east.js

@@ -0,0 +1,271 @@
+export const eastTools = [
+    {
+        name: "east_vision_inquiry",
+        description: "EAST Direction (Waabinong) - Spring, New Beginnings, Vision. Invoke tobacco medicine for new research inquiries, map relational obligations, and receive ceremony guidance for opening phases. Ages 0-7: Good Life stage.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                research_question: {
+                    type: "string",
+                    description: "The research question or inquiry you are beginning",
+                },
+                relations_involved: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of relations involved (youth, Elders, land, ancestors, future generations, etc.)",
+                },
+                cultural_context: {
+                    type: "string",
+                    description: "Indigenous territory/cultural context (e.g., Anishinaabe, Innu, Mi'kmaq)",
+                },
+                timeline_phase: {
+                    type: "string",
+                    enum: ["pre-research", "planning", "beginning"],
+                    description: "Current phase of research",
+                },
+            },
+            required: ["research_question", "relations_involved"],
+        },
+        handler: async (args) => {
+            const { research_question, relations_involved = [], cultural_context = "Indigenous territory", timeline_phase = "pre-research", } = args;
+            return {
+                direction: "EAST (Waabinong — Yellow — Spring — Tobacco)",
+                stage: "Birth-7 Years: Good Life (New Beginnings)",
+                ceremony_guidance: {
+                    opening_practice: "Smudging with tobacco",
+                    intention: "Honor spirits entering research circle; thank land & ancestors",
+                    protocol: "Place tobacco on ground; offer gratitude for all relations; acknowledge that knowledge belongs to community",
+                    medicines_used: ["Tobacco"],
+                    timeline: "Week 1",
+                },
+                relational_obligations: {
+                    human_relations: [
+                        "Listen deeply to community stories; honor perspectives as valid",
+                        "Invite Elders as co-investigators; their wisdom validates research",
+                        "Ensure community engagement & reciprocal benefit",
+                        "Live congruently with research values; demonstrate respect through actions",
+                    ],
+                    land_relations: [
+                        `Acknowledge ${cultural_context} territory and land's role in knowledge`,
+                        "Ground research in place; land teaches",
+                        "Recognize how knowledge connects to natural cycles",
+                    ],
+                    spirit_relations: [
+                        "Protect stories; don't extract or commodify knowledge",
+                        "Invoke ancestral guidance; honor those who came before",
+                        "Treat information as alive; it teaches through relationship",
+                    ],
+                    future_relations: [
+                        "Consider next 7 generations in all decisions",
+                        "Archive knowledge for community (not just academic publication)",
+                        "Ensure data sovereignty; community retains control",
+                        "Research as opportunity for healing & revitalization",
+                    ],
+                },
+                suggested_practices: [
+                    {
+                        name: "Spirit Invitation Ceremony",
+                        description: "Gather community, Elders, researchers in talking circle; invite spirits via storytelling",
+                        medicines_used: ["Tobacco", "Sage"],
+                        timeline: "Week 1",
+                    },
+                    {
+                        name: "Elder Co-Investigator Onboarding",
+                        description: "Formal role definition; co-authorship; decision-making authority",
+                        reciprocal_benefit: "Honorarium, co-authorship, community publication",
+                        timeline: "Week 2",
+                    },
+                    {
+                        name: "Community Advisory Circle",
+                        description: "Community guides research design; perspectives shape methods",
+                        protocol: "Talking circle format; stories shared before data collection planned",
+                        timeline: "Week 2-3",
+                    },
+                    {
+                        name: "Land-Based Opening",
+                        description: "Conduct first ceremony on land to ground research relationally",
+                        acknowledgment: `Thank land, acknowledge Indigenous history of ${cultural_context}`,
+                        timeline: "Week 3",
+                    },
+                ],
+                accountability_checkpoint: {
+                    question: `Does this research honor the spirits of community, land, and ancestors in ${cultural_context}?`,
+                    next_steps: [
+                        "Schedule smudging ceremony",
+                        "Identify Elder co-investigator",
+                        "Form community advisory circle",
+                        "Develop OCAP® data stewardship agreement",
+                        "Define reciprocal benefit for community",
+                    ],
+                },
+                relational_accountability_summary: {
+                    wilson_paradigm_alignment: "Research beginning to embody relational accountability; spirit invocation in place",
+                    two_eyed_seeing: "Community knowledge (Indigenous) + research rigor (Western) = bridged perspective",
+                    medicine_wheel: "East direction: New beginning honoring; community as springtime of research",
+                    next_phase: "South (Summer) will focus on growth practices & embodied learning",
+                },
+                research_question,
+                relations_involved,
+                timeline_phase,
+            };
+        },
+    },
+    {
+        name: "east_spirit_invocation",
+        description: "Guidance for opening ceremonies, invoking spirits, and establishing sacred research space. Provides tobacco protocol and gratitude practices.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ceremony_type: {
+                    type: "string",
+                    enum: ["research_opening", "land_acknowledgment", "elder_invitation"],
+                    description: "Type of opening ceremony",
+                },
+                participants: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Who will participate (Elders, youth, researchers, etc.)",
+                },
+            },
+            required: ["ceremony_type"],
+        },
+        handler: async (args) => {
+            const { ceremony_type, participants = [] } = args;
+            return {
+                direction: "EAST - Spirit Invocation",
+                ceremony_type,
+                protocol: {
+                    preparation: [
+                        "Gather tobacco or other appropriate medicine",
+                        "Prepare sacred space (clean, respectful environment)",
+                        "Invite participants with proper notice and respect",
+                        "Ensure Elder presence and guidance",
+                    ],
+                    opening: [
+                        "Begin with silence or song",
+                        "Offer tobacco to the four directions",
+                        "State intention clearly and humbly",
+                        "Acknowledge all relations (human, land, spirit, ancestors)",
+                    ],
+                    during: [
+                        "Listen deeply; create space for all voices",
+                        "Honor storytelling; don't interrupt or extract",
+                        "Remain present and attentive",
+                        "Follow Elder guidance for ceremony flow",
+                    ],
+                    closing: [
+                        "Express gratitude to all who participated",
+                        "Thank spirits, land, and ancestors",
+                        "Confirm next steps and ongoing relationships",
+                        "Ensure reciprocity is clear",
+                    ],
+                },
+                medicines: {
+                    tobacco: "Primary medicine for East; gratitude, humility, connection to all life",
+                    usage: "Offer to land, carry in pouch, burn in ceremony",
+                    teaching: "Tobacco carries prayers; use with respect and intention",
+                },
+                participants,
+                reminder: "Research is ceremony. This is not a checkbox but a sacred act of building relationships.",
+            };
+        },
+    },
+    {
+        name: "east_new_relation_mapper",
+        description: "Map all relational obligations at the start of research: human, land, spirit, ancestors, future generations. Ensures nothing is forgotten.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_title: {
+                    type: "string",
+                    description: "Title of the research project",
+                },
+                community: {
+                    type: "string",
+                    description: "Community or territory involved",
+                },
+            },
+            required: ["project_title", "community"],
+        },
+        handler: async (args) => {
+            const { project_title, community } = args;
+            return {
+                direction: "EAST - Relational Mapping",
+                project_title,
+                community,
+                relational_web: {
+                    human_relations: {
+                        description: "People directly and indirectly involved",
+                        mapping: [
+                            "Elders: Co-investigators, wisdom holders, ceremony guides",
+                            "Community members: Participants, advisory board, decision-makers",
+                            "Youth: Future knowledge holders, participants, mentees",
+                            "Researchers: Responsible for living congruently with topic",
+                            "Family networks: Extended relations, kinship systems",
+                            "Future researchers: Those who will build on this work",
+                        ],
+                        obligations: [
+                            "Obtain informed consent that honors community protocols",
+                            "Ensure co-authorship and equitable credit",
+                            "Provide ongoing updates and transparency",
+                            "Deliver reciprocal benefits (honoraria, capacity building, publications)",
+                        ],
+                    },
+                    land_relations: {
+                        description: "Territory, waters, ecology as active participants",
+                        mapping: [
+                            `${community} territory: Acknowledge Indigenous sovereignty`,
+                            "Waters: Rivers, lakes as knowledge holders",
+                            "Plants & animals: Relatives in ecosystem",
+                            "Seasons & cycles: Timing of research respects natural rhythms",
+                        ],
+                        obligations: [
+                            "Land acknowledgment at every gathering",
+                            "Conduct ceremonies on land (with permission)",
+                            "Minimize environmental impact",
+                            "Learn from land; it teaches if we listen",
+                        ],
+                    },
+                    spirit_relations: {
+                        description: "Non-physical beings, ancestors, knowledge spirits",
+                        mapping: [
+                            "Ancestors: Those who came before; wisdom carriers",
+                            "Spirit of knowledge: Information has life; treat with respect",
+                            "Guardians of place: Spirits protecting territory",
+                            "Creator/Great Mystery: Source of all relations",
+                        ],
+                        obligations: [
+                            "Invoke spirits at ceremonies; invite their guidance",
+                            "Don't extract knowledge; co-create with spirit present",
+                            "Honor sacred protocols (smudging, offerings)",
+                            "Feed ancestors (spirit feeding ceremonies)",
+                        ],
+                    },
+                    future_relations: {
+                        description: "Next 7 generations and beyond",
+                        mapping: [
+                            "Unborn children: Their inheritance of knowledge",
+                            "Future scholars: Will they benefit or be harmed?",
+                            "Community continuity: Strengthening culture for future",
+                            "Healing lineages: Breaking colonial patterns",
+                        ],
+                        obligations: [
+                            "Archive knowledge for community ownership (OCAP®)",
+                            "Build capacity for future Indigenous researchers",
+                            "Ensure sustainability of research relationships",
+                            "Leave community stronger than you found it",
+                        ],
+                    },
+                },
+                wilson_teaching: "Once you are in relationship, you are responsible for that relationship's wellbeing. This mapping ensures you know all your relations.",
+                next_steps: [
+                    "Review with Elder co-investigator",
+                    "Present to community advisory board for validation",
+                    "Incorporate into OCAP® data governance agreement",
+                    "Revisit quarterly to update and honor ongoing relationships",
+                ],
+            };
+        },
+    },
+];
+//# sourceMappingURL=east.js.map

package/dist/tools/east.js.map

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

package/dist/tools/epistemic.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Epistemic Tools — Importance Units & Relational Indexing
+ *
+ * These tools leverage the @medicine-wheel/importance-unit and
+ * @medicine-wheel/relational-index packages to manage weighted knowledge
+ * and track the spiral journey of understanding.
+ */
+import type { Tool } from "../types.js";
+export declare const epistemicTools: Tool[];
+//# sourceMappingURL=epistemic.d.ts.map

package/dist/tools/epistemic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epistemic.d.ts","sourceRoot":"","sources":["../../src/tools/epistemic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,eAAO,MAAM,cAAc,EAAE,IAAI,EA0JhC,CAAC"}

package/dist/tools/epistemic.js

@@ -0,0 +1,159 @@
+/**
+ * Epistemic Tools — Importance Units & Relational Indexing
+ *
+ * These tools leverage the @medicine-wheel/importance-unit and
+ * @medicine-wheel/relational-index packages to manage weighted knowledge
+ * and track the spiral journey of understanding.
+ */
+import { createUnit, circleBack, detectDeepening } from "@medicine-wheel/importance-unit";
+import { store } from "../store.js";
+export const epistemicTools = [
+    {
+        name: "mw_create_importance_unit",
+        description: "Create a relationally-accountable ImportanceUnit. Assigns epistemic weight based on source (land, dream, code, vision) and initializes circle depth at 1.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                summary: {
+                    type: "string",
+                    description: "The relational meaning of this unit — what it holds, not just what it says",
+                },
+                source: {
+                    type: "string",
+                    enum: ["land", "dream", "code", "vision"],
+                    description: "Relational origin dimension of knowledge",
+                },
+                direction: {
+                    type: "string",
+                    enum: ["east", "south", "west", "north"],
+                    description: "Medicine Wheel quadrant alignment",
+                },
+                createdBy: {
+                    type: "string",
+                    description: "Agent or person creating this unit",
+                },
+                axiologicalPillar: {
+                    type: "string",
+                    enum: ["ontology", "epistemology", "methodology", "axiology"],
+                    description: "Wilson's axiological pillar addressed",
+                },
+                inquiryRef: {
+                    type: "string",
+                    description: "Reference to the parent inquiry or research cycle",
+                }
+            },
+            required: ["summary", "source", "direction", "createdBy"],
+        },
+        handler: async (args) => {
+            try {
+                const { summary, source, direction, createdBy, axiologicalPillar, inquiryRef } = args;
+                const unit = createUnit({
+                    summary,
+                    source: source,
+                    direction,
+                    createdBy,
+                    axiologicalPillar: axiologicalPillar,
+                    inquiryRef
+                });
+                // Map to flat knowledge node for existing UI compatibility
+                store.createNode({
+                    id: unit.id,
+                    type: "knowledge",
+                    name: summary.slice(0, 50) + (summary.length > 50 ? "..." : ""),
+                    description: summary,
+                    direction: unit.direction,
+                    metadata: {
+                        ...unit.meta,
+                        source: unit.source,
+                        epistemicWeight: unit.epistemicWeight,
+                        circleDepth: unit.circleDepth,
+                        axiologicalPillar: unit.axiologicalPillar,
+                        is_importance_unit: true,
+                        full_content: unit.content
+                    },
+                    created_at: unit.meta.createdAt,
+                    updated_at: unit.meta.createdAt
+                });
+                return {
+                    status: "created",
+                    unit_id: unit.id,
+                    epistemic_weight: unit.epistemicWeight,
+                    circle_depth: unit.circleDepth,
+                    message: `ImportanceUnit created with ${source}-state authority.`,
+                    teaching: "Knowledge has spirit; treat respectfully, not as property."
+                };
+            }
+            catch (error) {
+                return { status: "error", message: String(error) };
+            }
+        }
+    },
+    {
+        name: "mw_circle_back",
+        description: "Circle back to an existing ImportanceUnit to deepen its knowledge. Increments circle depth and records what shifted in this pass.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                unit_id: {
+                    type: "string",
+                    description: "ID of the ImportanceUnit to deepen",
+                },
+                shift: {
+                    type: "string",
+                    description: "What changed or deepened in this circle pass",
+                }
+            },
+            required: ["unit_id", "shift"],
+        },
+        handler: async (args) => {
+            try {
+                const { unit_id, shift } = args;
+                const node = store.getNode(unit_id);
+                if (!node || !node.metadata?.is_importance_unit) {
+                    return { status: "error", message: `ImportanceUnit ${unit_id} not found.` };
+                }
+                // Reconstruct IU from stored node
+                const currentUnit = {
+                    id: node.id,
+                    direction: node.direction,
+                    epistemicWeight: node.metadata.epistemicWeight,
+                    source: node.metadata.source,
+                    circleDepth: node.metadata.circleDepth,
+                    content: node.metadata.full_content,
+                    meta: {
+                        createdBy: node.metadata.createdBy,
+                        createdAt: node.created_at,
+                        traceId: node.metadata.traceId
+                    }
+                };
+                const deepened = circleBack(currentUnit, shift);
+                const analysis = detectDeepening(deepened);
+                // Update store
+                store.createNode({
+                    ...node,
+                    metadata: {
+                        ...node.metadata,
+                        epistemicWeight: deepened.epistemicWeight,
+                        circleDepth: deepened.circleDepth,
+                        full_content: deepened.content,
+                        lastCircledAt: deepened.meta.lastCircledAt
+                    },
+                    updated_at: deepened.meta.lastCircledAt || node.updated_at
+                });
+                return {
+                    status: "deepened",
+                    unit_id: deepened.id,
+                    new_circle_depth: deepened.circleDepth,
+                    new_epistemic_weight: deepened.epistemicWeight,
+                    is_deepening: analysis.isDeepening,
+                    message: `Unit deepened to circle ${deepened.circleDepth}.`,
+                    teaching: "Repetition is ceremony and deepening, not redundancy."
+                };
+            }
+            catch (error) {
+                return { status: "error", message: String(error) };
+            }
+        }
+    }
+];
+//# sourceMappingURL=epistemic.js.map

package/dist/tools/epistemic.js.map

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

package/dist/tools/governance-transformation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Governance & Transformation Tools
+ *
+ * These tools leverage @medicine-wheel/community-review,
+ * @medicine-wheel/consent-lifecycle, and @medicine-wheel/transformation-tracker
+ * to manage the relational health and validity of the research process.
+ */
+import type { Tool } from "../types.js";
+export declare const governanceTransformationTools: Tool[];
+//# sourceMappingURL=governance-transformation.d.ts.map

package/dist/tools/governance-transformation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-transformation.d.ts","sourceRoot":"","sources":["../../src/tools/governance-transformation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,eAAO,MAAM,6BAA6B,EAAE,IAAI,EA+K/C,CAAC"}

package/dist/tools/governance-transformation.js

@@ -0,0 +1,181 @@
+/**
+ * Governance & Transformation Tools
+ *
+ * These tools leverage @medicine-wheel/community-review,
+ * @medicine-wheel/consent-lifecycle, and @medicine-wheel/transformation-tracker
+ * to manage the relational health and validity of the research process.
+ */
+import { createReviewCircle } from "@medicine-wheel/community-review";
+import { grantConsent } from "@medicine-wheel/consent-lifecycle";
+import { snapshotUnderstanding, wilsonValidityCheck } from "@medicine-wheel/transformation-tracker";
+import { store } from "../store.js";
+export const governanceTransformationTools = [
+    {
+        name: "mw_review_circle_open",
+        description: "Open a community review circle for an artifact. Initializes in 'gathering' status, awaiting reviewers and talking circle entries.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                artifactId: {
+                    type: "string",
+                    description: "ID of the artifact (e.g., knowledge node, cycle, chart) to review",
+                },
+                artifactType: {
+                    type: "string",
+                    enum: ["research", "ceremony", "knowledge", "code", "narrative"],
+                    description: "Type of artifact being reviewed",
+                }
+            },
+            required: ["artifactId", "artifactType"],
+        },
+        handler: async (args) => {
+            try {
+                const { artifactId, artifactType } = args;
+                const circle = createReviewCircle(artifactId, artifactType);
+                // Persist as a specialized node for UI visibility
+                store.createNode({
+                    id: circle.id,
+                    type: "knowledge",
+                    name: `Review Circle: ${artifactId}`,
+                    description: `Community review for ${artifactType} [${artifactId}]`,
+                    metadata: {
+                        is_review_circle: true,
+                        circle_status: circle.status,
+                        artifact_id: circle.artifactId,
+                        artifact_type: circle.artifactType,
+                        full_circle_state: circle
+                    },
+                    created_at: circle.createdAt,
+                    updated_at: circle.createdAt
+                });
+                return {
+                    status: "opened",
+                    circle_id: circle.id,
+                    message: "Community review circle initiated.",
+                    teaching: "Validation comes through community consensus, not individual judgment."
+                };
+            }
+            catch (error) {
+                return { status: "error", message: String(error) };
+            }
+        }
+    },
+    {
+        name: "mw_consent_grant",
+        description: "Record the initial granting of relational consent. Transitions from 'pending' to 'granted' and establishes the initial scope.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: { type: "string", description: "Unique consent identifier" },
+                grantor: { type: "string", description: "Who gave consent" },
+                grantee: { type: "string", description: "Who received consent" },
+                scopeDescription: { type: "string", description: "Human-readable description of the consent scope" },
+                dataTypes: { type: "array", items: { type: "string" }, description: "Types of data covered" },
+                purposes: { type: "array", items: { type: "string" }, description: "Consented purposes" }
+            },
+            required: ["grantor", "grantee", "scopeDescription"],
+        },
+        handler: async (args) => {
+            try {
+                const { id, grantor, grantee, scopeDescription, dataTypes = [], purposes = [] } = args;
+                const record = {
+                    id: id || `consent:${Date.now()}`,
+                    grantor,
+                    grantee,
+                    scope: {
+                        description: scopeDescription,
+                        dataTypes,
+                        purposes,
+                        restrictions: []
+                    },
+                    state: 'pending',
+                    ceremonies: [],
+                    history: [],
+                    communityLevel: false,
+                    dependentRelations: [],
+                    ocapFlags: { compliant: false }
+                };
+                const granted = grantConsent(record);
+                store.createNode({
+                    id: granted.id,
+                    type: "knowledge",
+                    name: `Consent: ${grantor} ──▶ ${grantee}`,
+                    description: scopeDescription,
+                    metadata: {
+                        is_consent_record: true,
+                        consent_state: granted.state,
+                        full_record: granted
+                    },
+                    created_at: new Date().toISOString(),
+                    updated_at: new Date().toISOString()
+                });
+                return {
+                    status: "granted",
+                    consent_id: granted.id,
+                    message: "Relational consent granted.",
+                    teaching: "Consent is a relationship, not an event. You are now responsible for its wellbeing."
+                };
+            }
+            catch (error) {
+                return { status: "error", message: String(error) };
+            }
+        }
+    },
+    {
+        name: "mw_snapshot_transformation",
+        description: "Capture a snapshot of researcher understanding and perform a Wilson validity audit. Tracks growth, community impact, and relational shifts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                researchCycleId: { type: "string", description: "ID of the research cycle being tracked" },
+                understanding: { type: "string", description: "Free-text description of current understanding" },
+                direction: { type: "string", enum: ["east", "south", "west", "north"], description: "Current direction alignment" },
+                ceremonyPhase: { type: "string", enum: ["opening", "council", "integration", "closure"], description: "Current ceremony phase" },
+                keyInsights: { type: "array", items: { type: "string" }, description: "New insights gained" },
+                openQuestions: { type: "array", items: { type: "string" }, description: "Remaining open questions" }
+            },
+            required: ["researchCycleId", "understanding", "direction", "ceremonyPhase"],
+        },
+        handler: async (args) => {
+            try {
+                const { researchCycleId, understanding, direction, ceremonyPhase, keyInsights = [], openQuestions = [] } = args;
+                // Simple log initialization (in real use, we'd load existing log)
+                const log = {
+                    id: `trans:${researchCycleId}`,
+                    researchCycleId,
+                    snapshots: [],
+                    reflections: [],
+                    communityImpacts: [],
+                    relationalShifts: [],
+                    reciprocityLedger: [],
+                    sevenGenerationScore: 0,
+                    overallTransformation: 0
+                };
+                const snapshot = {
+                    timestamp: new Date().toISOString(),
+                    direction,
+                    ceremonyPhase,
+                    understanding,
+                    relationsCount: 0, // Should be calculated from store in full implementation
+                    wilsonAlignment: 0.5,
+                    keyInsights,
+                    openQuestions
+                };
+                const updatedLog = snapshotUnderstanding(log, snapshot);
+                const validity = wilsonValidityCheck(updatedLog);
+                return {
+                    status: "snapshot_taken",
+                    wilson_validity: validity,
+                    overall_valid: validity.overallValid,
+                    score: validity.score,
+                    recommendations: validity.recommendations,
+                    teaching: "If research doesn't change you, you haven't done it right."
+                };
+            }
+            catch (error) {
+                return { status: "error", message: String(error) };
+            }
+        }
+    }
+];
+//# sourceMappingURL=governance-transformation.js.map