@cotrrackpro-dev/sdk 0.1.0

package/schemas/knowledge.index.json

@@ -0,0 +1,49 @@
+{
+  "_comment": "Snapshot of CoTrackPro shared knowledge files, synced via sdk/scripts/sync-antigravity.ts from cotrackpro-antigravity/knowledge/shared/*.md. related_modules is a curated linkage (see sync-antigravity.ts). Run `npm run codegen` to regenerate src/mcp/knowledge.generated.ts.",
+  "source": "cotrackpro-antigravity :: knowledge/shared/*.md",
+  "knowledge": [
+    {
+      "name": "coercive-control-framework",
+      "title": "Coercive Control Framework",
+      "summary": "The Asymmetry Principle for identifying coercive control patterns. Isolation, financial control, surveillance, system weaponization, and DARVO patterns. Documentation approaches that capture patterns without labeling. Evidence-based research on coercive control in family court co",
+      "related_modules": [
+        "coercive-control-awareness",
+        "safety-language"
+      ]
+    },
+    {
+      "name": "coparenting-best-practices",
+      "title": "Coparenting Best Practices",
+      "summary": "Best practices for co-parenting communication, documentation, and conflict resolution. Child-centered approach to parallel parenting. BIFF method for messaging. Documentation rhythm recommendations. Exchange protocol guidelines.",
+      "related_modules": [
+        "parent-support",
+        "emotional-deescalation"
+      ]
+    },
+    {
+      "name": "de-escalation-guide",
+      "title": "De Escalation Guide",
+      "summary": "De-escalation techniques for co-parent communication. The BIFF method (Brief, Informative, Friendly, Firm). Boundary-setting language. Response decision trees. When to respond vs. when to document and not respond. Emotional regulation before documenting.",
+      "related_modules": [
+        "emotional-deescalation"
+      ]
+    },
+    {
+      "name": "documentation-integrity",
+      "title": "Documentation Integrity",
+      "summary": "Standards for evidence-quality documentation. Timestamp integrity. Chain of custody. Source attribution. Neutrality requirements. Evidence preservation. Gap documentation. Pattern documentation. Court credibility factors.",
+      "related_modules": [
+        "neutral-documentation",
+        "evidence-integrity"
+      ]
+    },
+    {
+      "name": "trauma-informed-principles",
+      "title": "Trauma Informed Principles",
+      "summary": "Core principles of trauma-informed care applied to documentation and technology. Understanding trauma responses. Avoiding re-traumatization. Pacing and safety. Secondary trauma for professionals. Grounding techniques.",
+      "related_modules": [
+        "trauma-informed-response"
+      ]
+    }
+  ]
+}

package/schemas/prompt-modules.index.json

@@ -0,0 +1,105 @@
+{
+  "_comment": "Snapshot of CoTrackPro prompt modules. category/injection_point/version from the MCP `list_prompt_modules` surface; knowledge_refs added via sdk/scripts/sync-antigravity.ts (curated knowledge linkage). Run `npm run codegen` to regenerate src/mcp/prompt-modules.generated.ts.",
+  "source": "cotrackpro MCP `list_prompt_modules` + cotrackpro-antigravity knowledge linkage",
+  "modules": [
+    {
+      "name": "child-centered-language",
+      "category": "safety",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": []
+    },
+    {
+      "name": "coercive-control-awareness",
+      "category": "safety",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": [
+        "coercive-control-framework"
+      ]
+    },
+    {
+      "name": "community-support",
+      "category": "community",
+      "injection_point": "pre_prompt",
+      "version": "1.0",
+      "knowledge_refs": []
+    },
+    {
+      "name": "educational-tone",
+      "category": "educational",
+      "injection_point": "pre_prompt",
+      "version": "1.0",
+      "knowledge_refs": []
+    },
+    {
+      "name": "emotional-deescalation",
+      "category": "communication",
+      "injection_point": "pre_prompt",
+      "version": "1.0",
+      "knowledge_refs": [
+        "coparenting-best-practices",
+        "de-escalation-guide"
+      ]
+    },
+    {
+      "name": "evidence-integrity",
+      "category": "documentation",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": [
+        "documentation-integrity"
+      ]
+    },
+    {
+      "name": "legal-neutrality",
+      "category": "legal",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": []
+    },
+    {
+      "name": "neutral-documentation",
+      "category": "documentation",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": [
+        "documentation-integrity"
+      ]
+    },
+    {
+      "name": "parent-support",
+      "category": "communication",
+      "injection_point": "pre_prompt",
+      "version": "1.0",
+      "knowledge_refs": [
+        "coparenting-best-practices"
+      ]
+    },
+    {
+      "name": "safety-language",
+      "category": "safety",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": [
+        "coercive-control-framework"
+      ]
+    },
+    {
+      "name": "therapeutic-neutrality",
+      "category": "clinical",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": []
+    },
+    {
+      "name": "trauma-informed-response",
+      "category": "safety",
+      "injection_point": "guardrails",
+      "version": "1.0",
+      "knowledge_refs": [
+        "trauma-informed-principles"
+      ]
+    }
+  ]
+}

package/schemas/roles.index.json

@@ -0,0 +1,431 @@
+{
+  "_comment": "Snapshot of CoTrackPro role-shaped skills, synced via sdk/scripts/sync-antigravity.ts from cotrackpro-antigravity/.agents/roles/*/SKILL.md (+ scripts/role-airtable-mapping.json). Run `npm run codegen` to regenerate src/mcp/roles.generated.ts.",
+  "source": "cotrackpro-antigravity :: .agents/roles/*/SKILL.md",
+  "roles": [
+    {
+      "id": "cotrackpro-advocate",
+      "airtable_role_names": [
+        "Advocate",
+        "Domestic Violence Advocate",
+        "Victim Services Coordinator",
+        "Youth Advocate",
+        "Disability Rights Advocate"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "safety-review",
+        "incident-documentation"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-attorney",
+      "airtable_role_names": [
+        "Family Law Attorney",
+        "Legal Aid Attorney",
+        "Paralegal",
+        "Family Law Paralegal"
+      ],
+      "composes": [
+        "evidence-organization",
+        "timeline-builder",
+        "legal-document-formatter",
+        "omni-build"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "evidence-integrity",
+        "legal-neutrality",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-bailiff",
+      "airtable_role_names": [
+        "Court Security Officer",
+        "Security Officer",
+        "Court Reporter"
+      ],
+      "composes": [
+        "safety-review",
+        "incident-documentation"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "sensitive"
+    },
+    {
+      "id": "cotrackpro-clerk",
+      "airtable_role_names": [
+        "Court Clerk",
+        "Court Administrator",
+        "Court Case Manager",
+        "Court Liaison",
+        "Court Services Officer",
+        "Court Interpreter"
+      ],
+      "composes": [
+        "legal-document-formatter",
+        "omni-build"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "evidence-integrity",
+        "legal-neutrality",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "sensitive"
+    },
+    {
+      "id": "cotrackpro-coach",
+      "airtable_role_names": [
+        "Peer Support Specialist",
+        "Family Support Worker",
+        "Family Support Coordinator",
+        "Family Engagement Specialist"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "communication-tone-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "neutral-documentation",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "sensitive"
+    },
+    {
+      "id": "cotrackpro-evaluator",
+      "airtable_role_names": [
+        "Evaluator",
+        "Clinical Psychologist",
+        "Therapist",
+        "Child Therapist"
+      ],
+      "composes": [
+        "emotional-pattern-analysis",
+        "incident-documentation",
+        "safety-review"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-gal",
+      "airtable_role_names": [
+        "GAL (Guardian ad Litem)",
+        "Court-Appointed Special Advocate",
+        "CASA Volunteer",
+        "Child Advocate",
+        "Child Advocate Attorney"
+      ],
+      "composes": [
+        "safety-review",
+        "child-centered-rewrite",
+        "emotional-pattern-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-judge",
+      "airtable_role_names": [
+        "Judge",
+        "Family Court Judge",
+        "Domestic Relations Judge",
+        "Juvenile Court Judge",
+        "Probate Judge"
+      ],
+      "composes": [
+        "safety-review",
+        "legal-document-formatter",
+        "omni-build"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "legal-neutrality",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-mediator",
+      "airtable_role_names": [
+        "Mediator",
+        "Family Mediator",
+        "Community Mediator",
+        "Restorative Justice Facilitator",
+        "Restorative Justice Coordinator"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "safety-review",
+        "communication-tone-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parent-alienation-support",
+      "airtable_role_names": [
+        "Parent",
+        "Guardian"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "incident-documentation",
+        "safety-review",
+        "emotional-pattern-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parent-coparent",
+      "airtable_role_names": [
+        "Parent",
+        "Guardian"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "incident-documentation",
+        "safety-review"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parent-high-conflict-strategy",
+      "airtable_role_names": [
+        "Parent",
+        "Guardian"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "safety-review",
+        "communication-tone-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parent-pro-se",
+      "airtable_role_names": [
+        "Parent",
+        "Guardian"
+      ],
+      "composes": [
+        "timeline-builder",
+        "evidence-organization",
+        "legal-document-formatter",
+        "omni-build"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "evidence-integrity",
+        "legal-neutrality",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parent-survivor-safety",
+      "airtable_role_names": [
+        "Parent",
+        "Guardian"
+      ],
+      "composes": [
+        "safety-review",
+        "incident-documentation",
+        "evidence-organization"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "legal-neutrality",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-parenting-coordinator",
+      "airtable_role_names": [
+        "Parenting Coordinator"
+      ],
+      "composes": [
+        "child-centered-rewrite",
+        "incident-documentation",
+        "communication-tone-analysis"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-police",
+      "airtable_role_names": [
+        "Police Officer",
+        "School Resource Officer",
+        "Probation Officer",
+        "Juvenile Probation Officer"
+      ],
+      "composes": [
+        "safety-review",
+        "incident-documentation"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "emotional-deescalation",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "confidential"
+    },
+    {
+      "id": "cotrackpro-roles-router",
+      "airtable_role_names": [],
+      "composes": [
+        "omni-build"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "internal"
+    },
+    {
+      "id": "cotrackpro-supervisor",
+      "airtable_role_names": [
+        "Foster Care Caseworker",
+        "Child Welfare Supervisor",
+        "Case Management Supervisor"
+      ],
+      "composes": [
+        "omni-build",
+        "incident-documentation"
+      ],
+      "prompt_modules": [
+        "child-centered-language",
+        "evidence-integrity",
+        "neutral-documentation",
+        "safety-language",
+        "trauma-informed-response"
+      ],
+      "chains_with": [],
+      "safety_level": "elevated",
+      "data_sensitivity": "sensitive"
+    }
+  ]
+}

package/schemas/scenarios.index.json

@@ -0,0 +1,15 @@
+{
+  "_comment": "Snapshot of CoTrackPro MCP scenarios, synced via `list_scenarios` (metadata) + `get_scenario` (steps). Run `npm run codegen` to regenerate src/mcp/scenarios.generated.ts.",
+  "source": "cotrackpro MCP server :: list_scenarios + get_scenario",
+  "scenarios": [
+    { "name": "first-court-hearing", "title": "Prepare for your first court hearing", "audience": "personal", "goal": "Walk out with a clear sense of what kinds of artifacts come up, a court-readiness checklist for the most likely ones, and state-specific links to the court self-help portal.", "step_count": 5, "steps": ["get_started — Sets the chat register and surfaces state-specific legal-aid + court self-help links.", "search_artifacts — Find the court-facing artifacts that fit your hearing type.", "get_artifact_schema — Pull the schema + before_filing_checklist for one specific artifact so you know what's required.", "draft_artifact — Generate a first draft from your own words. The tool pseudonymizes the child and uses neutral language.", "list_skills — Find functional skills (e.g., court-readiness review) for self-review before filing."] },
+    { "name": "school-incident", "title": "Document a school incident involving your child", "audience": "personal", "goal": "Capture the incident in a structured, court-readable artifact and, if appropriate, draft a clear school-communication message.", "step_count": 3, "steps": ["draft_artifact — Generates an incident-log entry with the right schema fields filled. Child is pseudonymized automatically.", "get_artifact_schema — Pull the schema for a school-communication artifact if you want to record outreach you sent to the school.", "rewrite_coparent_message — If you need to communicate about this incident, get a calmer rewrite before you send."] },
+    { "name": "custody-handoff-dispute", "title": "Document a dispute at a custody handoff", "audience": "personal", "goal": "Capture the handoff in a structured way, draft a calmer message to the other parent if needed, and surface safety resources if the dispute crossed into hostility.", "step_count": 3, "steps": ["draft_artifact — Generates an exchange-log entry tailored to custody handoffs — contemporaneous and neutral.", "rewrite_coparent_message — If you need to address it in writing, get STANDARD + FIRM rewrites so the message lowers temperature instead of raising it.", "get_started — If the handoff involved threats, intimidation, or violence, route to crisis resources BEFORE further documentation."] },
+    { "name": "mediation-prep", "title": "Prepare for a co-parenting mediation session", "audience": "personal", "goal": "Walk into mediation with a parenting-plan draft, a sense of the priority issues, and links to mediation directories if you still need to find a mediator.", "step_count": 3, "steps": ["draft_artifact — Generates a parenting-plan-draft from your situation. Mediators expect parents to come with positions — this gives you a starting point.", "get_artifact_schema — Review the parenting-plan schema's fields so you know what topics the mediator will likely surface (holidays, schools, medical, communication).", "find_tool_for — Surfaces cotrackpro://links/mediation (Mediate.com, ACR, AFCC) if you don't have a mediator yet."] },
+    { "name": "professional-intake", "title": "Intake a new family-law client (Professional)", "audience": "practice", "goal": "Produce a starter intake packet — case documentation, parenting-plan draft (if applicable), and an empty incident-log structure — in one bulk call.", "step_count": 3, "steps": ["get_started — Sets the chat register for practice work and surfaces dashboard + pricing links.", "bulk_draft_artifacts — Drafts 3 starter artifacts in one call. One item failing doesn't fail the batch.", "list_skills — Browse review rubrics (court-readiness, custody-evaluator) to apply to the drafted artifacts."] },
+    { "name": "protective-order-prep", "title": "Prepare to petition for a protective / restraining order", "audience": "personal", "goal": "Stabilize on safety resources first, then walk through what a protective-order petition typically contains and produce a starter incident timeline + safety plan.", "step_count": 5, "steps": ["get_started — Surfaces NDVH (1-800-799-7233), 988, and Childhelp BEFORE any documentation tool. If you're in immediate danger, those come first.", "find_example_for — Routes to the worked example case (morgan-protective) so you can see what a finished safety-risk packet looks like before drafting your own.", "draft_artifact — Generates a safety-plan artifact with crisis-language guardrails. Safety planning comes BEFORE filing, not after.", "draft_artifact — Produces a structured incident log. Most protective-order petitions are decided on the strength of contemporaneous documentation; a clean log helps an attorney or pro-se filer build the petition.", "find_tool_for — Surfaces cotrackpro://links/legal-aid + state-specific court-self-help links. Most states have free legal-aid clinics that take protective-order cases."] },
+    { "name": "relocation-petition", "title": "Petition the court to relocate with the children", "audience": "personal", "goal": "Walk through the documentation a relocation petition typically requires — the reason for the move, the revised parenting plan, the impact analysis — and produce a starter packet.", "step_count": 5, "steps": ["find_example_for — Routes to sam-relocation — the worked example case that walks a cross-state modification end-to-end (Missouri → Kansas, with the renegotiated parenting plan and the communication log of the negotiation).", "get_example_case — Read the full worked case before drafting your own. The negotiation language is the high-value piece — it shows how to propose a move without antagonizing the other parent.", "draft_artifact — Generate a revised parenting plan that explicitly addresses how the other parent's time gets preserved (or made up) despite the distance.", "draft_artifact — Courts heavily weight whether the moving parent gave reasonable notice and engaged in good-faith negotiation. The communication log is the evidence.", "find_tool_for — Relocation cases interact with the UCCJEA (Uniform Child Custody Jurisdiction and Enforcement Act) — surfaces legal-aid links + state-bar referral."] },
+    { "name": "child-support-modification", "title": "Modify an existing child-support order", "audience": "personal", "goal": "Walk through what a modification motion typically requires — proof of the changed circumstance, current financials, the proposed new amount — and produce a starter packet.", "step_count": 5, "steps": ["get_started — Surfaces state-specific child-support calculators + the procedural rules for filing a modification motion (most states use a 'substantial change in circumstances' standard).", "search_artifacts — Find the artifact schemas that fit a support modification — affidavit-of-financial-information, motion-to-modify, current-expenses-statement.", "draft_artifact — The affidavit is the heart of the motion — it explains WHY the existing order should change. Neutral language matters; this is read by a judge.", "list_skills — Find functional skills (e.g., court-readiness review) to self-review the affidavit before filing.", "find_tool_for — Surfaces legal-aid links. Most state child-support agencies (Title IV-D offices) will modify an order for free if you meet the threshold; an attorney isn't always required."] },
+    { "name": "holiday-schedule-negotiation", "title": "Negotiate a holiday parenting-time schedule", "audience": "personal", "goal": "Walk into the conversation with a concrete proposal, a calmer way to communicate it, and a sense of what 'typical' holiday schedules look like so you have a defensible baseline.", "step_count": 4, "steps": ["get_example_case — Read the mediated parenting-plan v3 — the holiday section is one of the most worked-through parts of the example. Use it as a structural reference.", "draft_artifact — Generate a parenting-plan section focused on holidays — specific alternation patterns, transportation responsibility, religious / cultural observances.", "rewrite_coparent_message — Before sending the proposal, run it through the rewriter. Holiday negotiations are emotionally loaded; the calmer-rewrite removes implicit demands and preserves your position.", "draft_artifact — If the negotiation breaks down and you end up in mediation or court, the communication-log is your evidence of good-faith engagement."] }
+  ]
+}