Raw schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid",
"description": "Workspace UUID this snapshot belongs to."
},
"source": {
"type": "string",
"enum": [
"mcp-remote",
"mcp-local",
"cli",
"desktop",
"other"
],
"description": "Which Pathrule surface produced this snapshot. Defaults to 'mcp-remote'."
},
"project_name": {
"type": "string",
"maxLength": 255
},
"root_path": {
"type": "string",
"maxLength": 1024,
"description": "Absolute root path if the AI is running on the user's machine; otherwise omit."
},
"git_remote_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"git_head": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
]
},
"branch": {
"anyOf": [
{
"type": "string",
"maxLength": 255
},
{
"type": "null"
}
]
},
"file_count": {
"type": "integer",
"minimum": 0
},
"total_size_bytes": {
"type": "integer",
"minimum": 0
},
"file_tree": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"type": {
"type": "string",
"enum": [
"file",
"dir"
]
},
"size": {
"type": "integer",
"minimum": 0
},
"depth": {
"type": "integer",
"minimum": 0
}
},
"required": [
"path",
"type"
],
"additionalProperties": false
},
"maxItems": 5000,
"description": "Flat list of files/directories. Cap at 5000."
},
"file_extensions_summary": {
"type": "object",
"additionalProperties": {
"type": "integer",
"minimum": 0
},
"description": "e.g. {\"ts\": 412, \"tsx\": 158, \"json\": 33}"
},
"top_level_dirs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"file_count": {
"type": "integer",
"minimum": 0
}
},
"required": [
"name"
],
"additionalProperties": false
},
"maxItems": 200
},
"sampled_contents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"bytes": {
"type": "integer",
"minimum": 0
},
"content": {
"type": "string",
"maxLength": 8192
}
},
"required": [
"path",
"content"
],
"additionalProperties": false
},
"maxItems": 50,
"description": "Truncated contents of up to 50 important files (README, manifest files, CLAUDE.md/AGENTS.md, primary configs). Each content field capped at ~4096 bytes."
},
"git_log_summary": {
"type": "string",
"maxLength": 32768,
"description": "Free-form summary of recent git activity if available (e.g. 'last 50 commits hot paths: src/foo.ts, src/bar.ts; bug fixes in api/')."
},
"ai_notes": {
"type": "string",
"maxLength": 8192,
"description": "Your own observations about the project structure, conventions, and obvious workspace seeds."
},
"metadata": {
"type": "object",
"additionalProperties": {},
"description": "Free-form additional structured data."
}
},
"required": [
"workspace_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}