mindwiki_propose_context_pack

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Suggested pack name. The user can rename in the app; never send a blank name."
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "One short sentence describing what the pack covers. Required."
    },
    "slug": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional slug; if omitted, derived from name."
    },
    "pages": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "description": "Pages with their roles. Each entry: { path, role, include_mode?, page_summary? }. Roles: entrypoint, orientation, current-state, source-of-truth, reference, log, speculative, appendix. include_mode: full | summary-first | summary-or-search.",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "role": {
            "type": "string",
            "enum": [
              "entrypoint",
              "orientation",
              "current-state",
              "source-of-truth",
              "reference",
              "log",
              "speculative",
              "appendix"
            ]
          },
          "include_mode": {
            "type": "string",
            "enum": [
              "full",
              "summary-first",
              "summary-or-search"
            ]
          },
          "page_summary": {
            "type": "string",
            "maxLength": 2000
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      }
    },
    "trigger_phrases": {
      "type": "array",
      "maxItems": 50,
      "description": "Short phrases that should fire this pack from a user goal. E.g. ['MindWiki development', 'roadmap', 'current product state']. Required when source is router_suggested.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      }
    },
    "aliases": {
      "type": "array",
      "maxItems": 50,
      "description": "Alternate names users may say for this pack.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    "tasks": {
      "type": "array",
      "maxItems": 50,
      "description": "Recurring tasks this pack supports.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "tags": {
      "type": "array",
      "maxItems": 50,
      "description": "Tags the pack thematically covers.",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "sensitive": {
      "type": "boolean",
      "description": "If true, this pack will NEVER be auto-routed and will only load via explicit user request. Cannot be true on router_suggested proposals."
    },
    "rationale": {
      "type": "string",
      "maxLength": 4000,
      "description": "Why this pack is useful. Recorded in the proposal."
    },
    "source": {
      "type": "string",
      "enum": [
        "router_suggested",
        "user_requested"
      ],
      "description": "'router_suggested' or 'user_requested'. Used by the validator to enforce the trigger-phrase + sensitive rules."
    },
    "plan_id": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional plan_id from a prior mindwiki_prepare_context call. Lets the proposal cite its evidence."
    },
    "evidence": {
      "type": "object",
      "maxProperties": 20,
      "description": "Optional evidence object: { similar_goal_count, retrieval_coherence, sample_goals }"
    }
  },
  "required": [
    "name",
    "description",
    "pages"
  ],
  "additionalProperties": false
}