Back to Docs

submit_feedback

meta

Submits practitioner feedback on a specific interpretive claim to tune Calibratable Interpretive Layer (CIL) weights. Only CIL parameters are affected — IDL (ephemeris, classical tables, combinatorial rules) is immutable.

When to use

When a practitioner disagrees with a yoga strength score, domain mapping weight, or school-specific threshold and wants to record their assessment for CIL calibration.

When NOT to use

For reporting data errors (those are IDL facts and not correctable via feedback). Never use to alter ephemeris or classical table lookups.

Input Schema

{
  "type": "object",
  "properties": {
    "chart_hash": {
      "type": "string",
      "description": "Content-addressable chart identifier from ChartArtifact.chart_hash"
    },
    "claim_id": {
      "type": "string",
      "description": "The claim being assessed (e.g. 'yoga_gajakesari_001')"
    },
    "assessment": {
      "type": "string",
      "enum": [
        "agree",
        "disagree",
        "partial"
      ],
      "description": "Practitioner's overall assessment of the claim"
    },
    "confidence": {
      "type": "number",
      "description": "Practitioner confidence 0.0–1.0"
    },
    "note": {
      "type": "string",
      "description": "Optional free-text note (not stored with PII)"
    },
    "school": {
      "type": "string",
      "enum": [
        "parashari",
        "jaimini",
        "kp"
      ]
    }
  },
  "required": [
    "chart_hash",
    "claim_id",
    "assessment"
  ]
}

Output

Acknowledgement with: feedback_id (UUID), weight_id affected, calibrated flag (true once threshold of feedback is reached), and message.

Example Request

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "submit_feedback",
    "arguments": {
      "chart_hash": "sha256:abc123",
      "claim_id": "yoga_gajakesari_001",
      "assessment": "agree",
      "confidence": 0.9,
      "school": "parashari"
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [
      {
        "type": "resource",
        "resource": {
          "uri": "kundalimcp://feedback/stu901",
          "mimeType": "application/json",
          "text": "{\"feedback_id\":\"f7a2bc91-...\",\"weight_id\":\"gajakesari_base_score\",\"calibrated\":false,\"message\":\"Feedback recorded. CIL weight update pending threshold.\"}"
        }
      }
    ]
  }
}
Previous: describe_school_profileNext: list_tools