{ "openapi": "3.1.0", "info": { "title": "StrategyForge AI API - intake", "version": "0.1.0" }, "paths": { "/engagements": { "post": { "tags": [ "intake" ], "summary": "Create Engagement", "description": "Create a new engagement (client project).\n- Body: client_id, organization_name, optional package_id.\n- Server generates id and sets status=ACTIVE, created_at, updated_at.", "operationId": "create_engagement_engagements_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}": { "get": { "tags": [ "intake" ], "summary": "Get Engagement", "description": "Fetch a single engagement by ID. Returns 404 if not found.", "operationId": "get_engagement_engagements__engagement_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Engagement", "description": "Delete an engagement and all its child resources (sessions and all session-scoped data).", "operationId": "delete_engagement_engagements__engagement_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions": { "get": { "tags": [ "intake" ], "summary": "List Sessions", "description": "List all interview sessions for this engagement.\nOptional query params filter by persona (e.g. CEO), tier, or session status.", "operationId": "list_sessions_engagements__engagement_id__sessions_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "persona", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona" } }, { "name": "tier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/SessionRead" }, "title": "Response List Sessions Engagements Engagement Id Sessions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Session", "description": "Start a new interview session for this engagement.\nBody: persona (e.g. CEO), tier, session_type, user_track. Status is set to IN_PROGRESS.", "operationId": "create_session_engagements__engagement_id__sessions_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}": { "get": { "tags": [ "intake" ], "summary": "Get Session By Id", "description": "Get one session by ID. We also check engagement_id so the session belongs to this engagement.", "operationId": "get_session_by_id_engagements__engagement_id__sessions__session_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Session", "description": "Partially update a session (e.g. set status, current_question_index).\nIf status is set to APPROVED, we also set completed_at.", "operationId": "update_session_engagements__engagement_id__sessions__session_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Session", "description": "Delete a session and all its child records (responses, delegations, summaries, etc.).", "operationId": "delete_session_engagements__engagement_id__sessions__session_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/questions": { "get": { "tags": [ "intake" ], "summary": "Get Session Questions", "description": "List questions for this session (session-scoped or linked via session_id).", "operationId": "get_session_questions_engagements__engagement_id__sessions__session_id__questions_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/QuestionRead" }, "title": "Response Get Session Questions Engagements Engagement Id Sessions Session Id Questions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Question", "description": "Add a question to this session.", "operationId": "create_question_engagements__engagement_id__sessions__session_id__questions_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/questions/{question_id}": { "patch": { "tags": [ "intake" ], "summary": "Update Question", "description": "Update a question.", "operationId": "update_question_engagements__engagement_id__sessions__session_id__questions__question_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "question_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Question Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Question", "description": "Delete a question.", "operationId": "delete_question_engagements__engagement_id__sessions__session_id__questions__question_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "question_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Question Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/delegations": { "get": { "tags": [ "intake" ], "summary": "List Delegations", "description": "List delegations for this session.", "operationId": "list_delegations_engagements__engagement_id__sessions__session_id__delegations_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaggedDelegateRead" }, "title": "Response List Delegations Engagements Engagement Id Sessions Session Id Delegations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Delegation", "description": "Create a delegation (tag a delegate for a question).", "operationId": "create_delegation_engagements__engagement_id__sessions__session_id__delegations_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaggedDelegateCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaggedDelegateRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/delegations/{delegation_id}": { "get": { "tags": [ "intake" ], "summary": "Get Delegation", "description": "Get one delegation by ID.", "operationId": "get_delegation_engagements__engagement_id__sessions__session_id__delegations__delegation_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "delegation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Delegation Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaggedDelegateRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Delegation", "description": "Update a delegation (e.g. status, response).", "operationId": "update_delegation_engagements__engagement_id__sessions__session_id__delegations__delegation_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "delegation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Delegation Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaggedDelegateUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaggedDelegateRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Delegation", "description": "Delete a delegation.", "operationId": "delete_delegation_engagements__engagement_id__sessions__session_id__delegations__delegation_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "delegation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Delegation Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/summaries": { "get": { "tags": [ "intake" ], "summary": "List Summaries", "description": "List Current Understanding summaries for this session.", "operationId": "list_summaries_engagements__engagement_id__sessions__session_id__summaries_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/SummaryRead" }, "title": "Response List Summaries Engagements Engagement Id Sessions Session Id Summaries Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Summary", "description": "Create a summary for this session.", "operationId": "create_summary_engagements__engagement_id__sessions__session_id__summaries_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SummaryCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SummaryRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/summaries/{summary_id}": { "get": { "tags": [ "intake" ], "summary": "Get Summary", "description": "Get one summary by ID.", "operationId": "get_summary_engagements__engagement_id__sessions__session_id__summaries__summary_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "summary_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Summary Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SummaryRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Summary", "description": "Update a summary.", "operationId": "update_summary_engagements__engagement_id__sessions__session_id__summaries__summary_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "summary_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Summary Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SummaryUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SummaryRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Summary", "description": "Delete a summary.", "operationId": "delete_summary_engagements__engagement_id__sessions__session_id__summaries__summary_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "summary_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Summary Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/maturity-scores": { "get": { "tags": [ "intake" ], "summary": "List Maturity Scores", "description": "List domain maturity scores for this session.", "operationId": "list_maturity_scores_engagements__engagement_id__sessions__session_id__maturity_scores_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DomainMaturityScoreRead" }, "title": "Response List Maturity Scores Engagements Engagement Id Sessions Session Id Maturity Scores Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Maturity Score", "description": "Create a domain maturity score for this session.", "operationId": "create_maturity_score_engagements__engagement_id__sessions__session_id__maturity_scores_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainMaturityScoreCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainMaturityScoreRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/maturity-scores/{score_id}": { "get": { "tags": [ "intake" ], "summary": "Get Maturity Score", "description": "Get one domain maturity score by ID.", "operationId": "get_maturity_score_engagements__engagement_id__sessions__session_id__maturity_scores__score_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "score_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Score Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainMaturityScoreRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Maturity Score", "description": "Update a domain maturity score.", "operationId": "update_maturity_score_engagements__engagement_id__sessions__session_id__maturity_scores__score_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "score_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Score Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainMaturityScoreUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DomainMaturityScoreRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Maturity Score", "description": "Delete a domain maturity score.", "operationId": "delete_maturity_score_engagements__engagement_id__sessions__session_id__maturity_scores__score_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "score_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Score Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/responses": { "post": { "tags": [ "intake" ], "summary": "Submit Response", "description": "Submit an answer (response) to a question in a session.\nBody: question_id, content, optional modality/source/answered_by/confidence.", "operationId": "submit_response_engagements__engagement_id__sessions__session_id__responses_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "intake" ], "summary": "List Responses", "description": "List all responses (answers) for this session.", "operationId": "list_responses_engagements__engagement_id__sessions__session_id__responses_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseRead" }, "title": "Response List Responses Engagements Engagement Id Sessions Session Id Responses Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/responses/{response_id}": { "patch": { "tags": [ "intake" ], "summary": "Update Response", "description": "Partially update a response (content, modality, source, answered_by, confidence, etc.).", "operationId": "update_response_engagements__engagement_id__sessions__session_id__responses__response_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "response_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Response Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Response", "description": "Delete a single response.", "operationId": "delete_response_engagements__engagement_id__sessions__session_id__responses__response_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "response_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Response Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/documents": { "post": { "tags": [ "intake" ], "summary": "Upload Document", "description": "Upload a document (multipart/form-data: file required; session_id and document_category optional).\nWe create a DocumentRecord with classification_status=PENDING. The actual file bytes are\nnot stored here yet (TODO: S3 or local storage + async classification).", "operationId": "upload_document_engagements__engagement_id__documents_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_document_engagements__engagement_id__documents_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "intake" ], "summary": "List Documents", "description": "List documents for this engagement. Optionally filter by session_id or classification_status.", "operationId": "list_documents_engagements__engagement_id__documents_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, { "name": "classification_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Classification Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DocumentRead" }, "title": "Response List Documents Engagements Engagement Id Documents Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/documents/{document_id}": { "get": { "tags": [ "intake" ], "summary": "Get Document", "description": "Get one document by ID, ensuring it belongs to this engagement.", "operationId": "get_document_engagements__engagement_id__documents__document_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "document_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Document Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Document", "description": "Delete a document record.", "operationId": "delete_document_engagements__engagement_id__documents__document_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "document_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Document Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/requirements": { "get": { "tags": [ "intake" ], "summary": "List Requirements", "description": "List requirement items for this engagement. Optional filters: persona, tier,\nclassification, validation_status. Returns list of dicts (model_dump).", "operationId": "list_requirements_engagements__engagement_id__requirements_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "persona", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona" } }, { "name": "tier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" } }, { "name": "classification", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Classification" } }, { "name": "validation_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Validation Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": {}, "title": "Response List Requirements Engagements Engagement Id Requirements Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Requirement", "description": "Create a new requirement item. Server sets id, created_at, updated_at.\nReturns the created record as a dict.", "operationId": "create_requirement_engagements__engagement_id__requirements_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequirementCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Requirement Engagements Engagement Id Requirements Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/requirements/{requirement_id}": { "get": { "tags": [ "intake" ], "summary": "Get Requirement", "description": "Get one requirement by ID. Returns a dict (model_dump).", "operationId": "get_requirement_engagements__engagement_id__requirements__requirement_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "requirement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Requirement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Requirement Engagements Engagement Id Requirements Requirement Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Requirement", "description": "Partially update a requirement (priority, content, rationale, validation_status, etc.).\nWe bump version and updated_at; change_history could be extended with AuditEntry later.", "operationId": "update_requirement_engagements__engagement_id__requirements__requirement_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "requirement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Requirement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequirementUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Requirement Engagements Engagement Id Requirements Requirement Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Requirement", "description": "Delete a requirement.", "operationId": "delete_requirement_engagements__engagement_id__requirements__requirement_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "requirement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Requirement Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/strategic-objectives": { "get": { "tags": [ "intake" ], "summary": "List Strategic Objectives", "description": "List strategic objectives for this engagement, ordered by rank.", "operationId": "list_strategic_objectives_engagements__engagement_id__strategic_objectives_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/StrategicObjectiveRead" }, "title": "Response List Strategic Objectives Engagements Engagement Id Strategic Objectives Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Strategic Objective", "description": "Create a strategic objective. Server sets id and created_at.", "operationId": "create_strategic_objective_engagements__engagement_id__strategic_objectives_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategicObjectiveCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategicObjectiveRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/strategic-objectives/{objective_id}": { "get": { "tags": [ "intake" ], "summary": "Get Strategic Objective", "description": "Get one strategic objective by ID.", "operationId": "get_strategic_objective_engagements__engagement_id__strategic_objectives__objective_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "objective_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Objective Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategicObjectiveRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Strategic Objective", "description": "Partially update a strategic objective.", "operationId": "update_strategic_objective_engagements__engagement_id__strategic_objectives__objective_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "objective_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Objective Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategicObjectiveUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategicObjectiveRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Strategic Objective", "description": "Delete a strategic objective.", "operationId": "delete_strategic_objective_engagements__engagement_id__strategic_objectives__objective_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "objective_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Objective Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/checkpoints/sign-off": { "post": { "tags": [ "intake" ], "summary": "Create Sign Off", "description": "Record a sign-off: actor (persona) approves the corpus at a checkpoint.\nBody: checkpoint, actor, optional actor_id, rationale, corpus_version.", "operationId": "create_sign_off_engagements__engagement_id__checkpoints_sign_off_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SignOffCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Sign Off Engagements Engagement Id Checkpoints Sign Off Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/checkpoints/sign-offs": { "get": { "tags": [ "intake" ], "summary": "List Sign Offs", "description": "List all sign-offs for this engagement (order depends on DB/query; typically by timestamp).", "operationId": "list_sign_offs_engagements__engagement_id__checkpoints_sign_offs_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Sign Offs Engagements Engagement Id Checkpoints Sign Offs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/checkpoints/sign-offs/{sign_off_id}": { "delete": { "tags": [ "intake" ], "summary": "Delete Sign Off", "description": "Delete a sign-off record.", "operationId": "delete_sign_off_engagements__engagement_id__checkpoints_sign_offs__sign_off_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "sign_off_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sign Off Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/alerts": { "get": { "tags": [ "intake" ], "summary": "List Session Alerts", "description": "List alerts for this session.", "operationId": "list_session_alerts_engagements__engagement_id__sessions__session_id__alerts_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AlertRead" }, "title": "Response List Session Alerts Engagements Engagement Id Sessions Session Id Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/alerts/{alert_id}": { "patch": { "tags": [ "intake" ], "summary": "Acknowledge Alert", "description": "Acknowledge (or unacknowledge) an alert.", "operationId": "acknowledge_alert_engagements__engagement_id__sessions__session_id__alerts__alert_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertAck" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/sessions/{session_id}/reminders": { "get": { "tags": [ "intake" ], "summary": "List Session Reminders", "description": "List reminders for this session.", "operationId": "list_session_reminders_engagements__engagement_id__sessions__session_id__reminders_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ReminderRead" }, "title": "Response List Session Reminders Engagements Engagement Id Sessions Session Id Reminders Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/audit-entries": { "get": { "tags": [ "intake" ], "summary": "List Audit Entries", "description": "List audit entries for this engagement (read-only).", "operationId": "list_audit_entries_engagements__engagement_id__audit_entries_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "entity_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AuditEntryRead" }, "title": "Response List Audit Entries Engagements Engagement Id Audit Entries Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/packages": { "get": { "tags": [ "intake" ], "summary": "List Engagement Packages", "description": "List engagement packages for this engagement's client.", "operationId": "list_engagement_packages_engagements__engagement_id__packages_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EngagementPackageRead" }, "title": "Response List Engagement Packages Engagements Engagement Id Packages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Engagement Package", "description": "Create an engagement package for this engagement's client.", "operationId": "create_engagement_package_engagements__engagement_id__packages_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementPackageCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementPackageRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/packages/{package_id}": { "get": { "tags": [ "intake" ], "summary": "Get Engagement Package", "description": "Get one engagement package by ID.", "operationId": "get_engagement_package_engagements__engagement_id__packages__package_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "package_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Package Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementPackageRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Engagement Package", "description": "Update an engagement package.", "operationId": "update_engagement_package_engagements__engagement_id__packages__package_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "package_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Package Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementPackageUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EngagementPackageRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Engagement Package", "description": "Delete an engagement package.", "operationId": "delete_engagement_package_engagements__engagement_id__packages__package_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "package_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Package Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/usage/logs": { "get": { "tags": [ "intake" ], "summary": "List Usage Logs", "description": "List token usage logs for this engagement's client.", "operationId": "list_usage_logs_engagements__engagement_id__usage_logs_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenUsageLogRead" }, "title": "Response List Usage Logs Engagements Engagement Id Usage Logs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Usage Log", "description": "Create a token usage log entry for this engagement's client.", "operationId": "create_usage_log_engagements__engagement_id__usage_logs_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenUsageLogCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenUsageLogRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/usage/logs/{log_id}": { "get": { "tags": [ "intake" ], "summary": "Get Usage Log", "description": "Get one token usage log by ID.", "operationId": "get_usage_log_engagements__engagement_id__usage_logs__log_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "log_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Log Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenUsageLogRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Usage Log", "description": "Update a token usage log (description/metadata only).", "operationId": "update_usage_log_engagements__engagement_id__usage_logs__log_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "log_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Log Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenUsageLogUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenUsageLogRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Usage Log", "description": "Delete a token usage log entry.", "operationId": "delete_usage_log_engagements__engagement_id__usage_logs__log_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "log_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Log Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/usage/alerts": { "get": { "tags": [ "intake" ], "summary": "List Usage Alerts", "description": "List usage alerts for this engagement's client.", "operationId": "list_usage_alerts_engagements__engagement_id__usage_alerts_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UsageAlertRead" }, "title": "Response List Usage Alerts Engagements Engagement Id Usage Alerts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "intake" ], "summary": "Create Usage Alert", "description": "Create a usage alert for this engagement's client.", "operationId": "create_usage_alert_engagements__engagement_id__usage_alerts_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageAlertCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageAlertRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/usage/alerts/{alert_id}": { "get": { "tags": [ "intake" ], "summary": "Get Usage Alert", "description": "Get one usage alert by ID.", "operationId": "get_usage_alert_engagements__engagement_id__usage_alerts__alert_id__get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageAlertRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "intake" ], "summary": "Update Usage Alert", "description": "Update a usage alert (e.g. acknowledge).", "operationId": "update_usage_alert_engagements__engagement_id__usage_alerts__alert_id__patch", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageAlertUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageAlertRead" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "intake" ], "summary": "Delete Usage Alert", "description": "Delete a usage alert.", "operationId": "delete_usage_alert_engagements__engagement_id__usage_alerts__alert_id__delete", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } }, { "name": "alert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Alert Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/corpus/assemble": { "post": { "tags": [ "intake" ], "summary": "Assemble Corpus", "description": "Trigger corpus assembly. Idempotent: the actual package is built on demand when\nyou call GET .../corpus (or GET /research/handoff/{engagement_id}). This endpoint\njust confirms the engagement exists and returns a status message.", "operationId": "assemble_corpus_engagements__engagement_id__corpus_assemble_post", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Assemble Corpus Engagements Engagement Id Corpus Assemble Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/engagements/{engagement_id}/corpus": { "get": { "tags": [ "intake" ], "summary": "Get Corpus", "description": "Build and return the ResearchAgentInputPackage for this engagement.\nThis is the main \"handoff\" payload: the research engine uses it as input.\nWe load engagements, sign-offs, documents, and sessions from the DB, then\nconstruct the contract type ResearchAgentInputPackage (metadata, strategic\ncontext, domain requirements, supporting documents, etc.). Strategic context,\nrequirements, and traceability are still minimal stubs; they can be filled\nfrom requirements and config later.", "operationId": "get_corpus_engagements__engagement_id__corpus_get", "parameters": [ { "name": "engagement_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Engagement Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchAgentInputPackage" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "AlertAck": { "properties": { "acknowledged": { "type": "boolean", "title": "Acknowledged", "default": true } }, "type": "object", "title": "AlertAck" }, "AlertRead": { "properties": { "id": { "type": "string", "title": "Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "alert_type": { "type": "string", "title": "Alert Type" }, "message": { "type": "string", "title": "Message" }, "question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Id" }, "document_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Document Id" }, "severity": { "type": "string", "title": "Severity" }, "acknowledged": { "type": "boolean", "title": "Acknowledged" } }, "type": "object", "required": [ "id", "session_id", "alert_type", "message", "question_id", "document_id", "severity", "acknowledged" ], "title": "AlertRead" }, "AuditActionType": { "type": "string", "enum": [ "APPROVE", "REVISE", "REJECT", "EDIT", "ADD_DOCUMENT", "REMOVE_DOCUMENT", "RECLASSIFY", "PRIORITY_CHANGE", "CONFLICT_RESOLVE", "SIGN_OFF", "OTHER" ], "title": "AuditActionType" }, "AuditEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "actor": { "anyOf": [ { "$ref": "#/components/schemas/Persona" }, { "type": "string", "const": "SYSTEM" } ], "title": "Actor" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "timestamp": { "type": "string", "title": "Timestamp" }, "action_type": { "$ref": "#/components/schemas/AuditActionType" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "impact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Impact" }, "version_before": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version Before" }, "version_after": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version After" }, "entity_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Type" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Id" }, "field_changed": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Field Changed" }, "old_value": { "title": "Old Value" }, "new_value": { "title": "New Value" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Metadata" } }, "type": "object", "required": [ "id", "actor", "timestamp", "action_type" ], "title": "AuditEntry", "description": "Single human action for full traceability (Section 14.8.1)." }, "AuditEntryRead": { "properties": { "id": { "type": "string", "title": "Id" }, "actor": { "type": "string", "title": "Actor" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "timestamp": { "type": "string", "format": "date-time", "title": "Timestamp" }, "action_type": { "type": "string", "title": "Action Type" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "impact": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Impact" }, "entity_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Type" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Id" }, "engagement_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Engagement Id" } }, "type": "object", "required": [ "id", "actor", "actor_id", "timestamp", "action_type", "rationale", "impact", "entity_type", "entity_id", "engagement_id" ], "title": "AuditEntryRead" }, "Body_upload_document_engagements__engagement_id__documents_post": { "properties": { "file": { "type": "string", "contentMediaType": "application/octet-stream", "title": "File" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "document_category": { "type": "string", "title": "Document Category", "default": "STRATEGIC" } }, "type": "object", "required": [ "file" ], "title": "Body_upload_document_engagements__engagement_id__documents_post" }, "CapabilityDomainPriority": { "properties": { "ref_arch_type": { "$ref": "#/components/schemas/RefArchType" }, "domain_name": { "type": "string", "title": "Domain Name" }, "priority": { "type": "string", "enum": [ "P0", "P1", "P2", "P3" ], "title": "Priority" }, "prioritized_by": { "items": { "$ref": "#/components/schemas/Persona" }, "type": "array", "title": "Prioritized By", "default": [] }, "vision_track_signal": { "type": "boolean", "title": "Vision Track Signal" }, "execution_track_signal": { "type": "boolean", "title": "Execution Track Signal" }, "alignment": { "type": "string", "enum": [ "ALIGNED", "PARTIAL", "MISALIGNED" ], "title": "Alignment" } }, "type": "object", "required": [ "ref_arch_type", "domain_name", "priority", "vision_track_signal", "execution_track_signal", "alignment" ], "title": "CapabilityDomainPriority", "description": "Aggregated priority signal for a reference architecture capability domain." }, "CapabilityGap": { "properties": { "ref_arch_type": { "$ref": "#/components/schemas/RefArchType" }, "domain_name": { "type": "string", "title": "Domain Name" }, "current_maturity": { "type": "integer", "title": "Current Maturity" }, "target_maturity": { "type": "integer", "title": "Target Maturity" }, "gap_severity": { "type": "string", "enum": [ "CRITICAL", "SIGNIFICANT", "MODERATE", "MINOR" ], "title": "Gap Severity" }, "identified_by": { "items": { "$ref": "#/components/schemas/Persona" }, "type": "array", "title": "Identified By", "default": [] }, "existing_tools": { "items": { "type": "string" }, "type": "array", "title": "Existing Tools", "default": [] }, "notes": { "type": "string", "title": "Notes" } }, "type": "object", "required": [ "ref_arch_type", "domain_name", "current_maturity", "target_maturity", "gap_severity", "notes" ], "title": "CapabilityGap", "description": "Gap between current and target maturity in a reference architecture capability domain." }, "Checkpoint": { "type": "string", "enum": [ "TIER_1_COMPLETE", "TIER_2_COMPLETE", "TIER_3_COMPLETE", "CORPUS_APPROVED", "ENGAGEMENT_APPROVED" ], "title": "Checkpoint" }, "Classification": { "type": "string", "enum": [ "CONSTRAINT", "CONTEXT", "EVIDENCE", "REQUIREMENT", "PAIN_POINT", "DECISION" ], "title": "Classification" }, "ConflictResolution": { "properties": { "id": { "type": "string", "title": "Id" }, "requirement_id": { "type": "string", "title": "Requirement Id" }, "conflict_type": { "$ref": "#/components/schemas/ConflictType" }, "resolution": { "$ref": "#/components/schemas/ResolutionMethod" }, "final_priority": { "$ref": "#/components/schemas/PriorityShort" }, "rationale": { "type": "string", "title": "Rationale" }, "participant_inputs": { "items": { "$ref": "#/components/schemas/PersonaPriorityInput" }, "type": "array", "title": "Participant Inputs" }, "resolved_at": { "type": "string", "title": "Resolved At" }, "resolved_by": { "anyOf": [ { "$ref": "#/components/schemas/Persona" }, { "type": "string", "const": "SYSTEM" }, { "type": "null" } ], "title": "Resolved By" } }, "type": "object", "required": [ "id", "requirement_id", "conflict_type", "resolution", "final_priority", "rationale", "participant_inputs", "resolved_at" ], "title": "ConflictResolution", "description": "Resolved priority conflict with rationale." }, "ConflictType": { "type": "string", "enum": [ "PRIORITY", "FACTUAL", "CONSTRAINT", "SCOPE" ], "title": "ConflictType" }, "Constraint": { "properties": { "id": { "type": "string", "title": "Id" }, "constraint_type": { "$ref": "#/components/schemas/ConstraintType" }, "priority": { "$ref": "#/components/schemas/Priority" }, "content": { "type": "string", "title": "Content" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "source_requirement_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Requirement Id" }, "source_document_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Document Id" } }, "type": "object", "required": [ "id", "constraint_type", "priority", "content" ], "title": "Constraint", "description": "P0\u2013P3 constraint item for the research engine." }, "ConstraintType": { "type": "string", "enum": [ "REGULATORY", "CONTRACTUAL", "SECURITY", "FINANCIAL", "ORG", "TECHNICAL", "OPERATIONAL", "PREFERENCE" ], "title": "ConstraintType" }, "Document": { "properties": { "id": { "type": "string", "title": "Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "engagement_id": { "type": "string", "title": "Engagement Id" }, "filename": { "type": "string", "title": "Filename" }, "content_type": { "type": "string", "title": "Content Type" }, "document_category": { "$ref": "#/components/schemas/DocumentCategory" }, "classification_status": { "type": "string", "enum": [ "PENDING", "CLASSIFIED", "EXTRACTED", "FAILED" ], "title": "Classification Status" }, "extracted_requirement_ids": { "items": { "type": "string" }, "type": "array", "title": "Extracted Requirement Ids" }, "page_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Page Count" }, "processing_errors": { "items": { "type": "string" }, "type": "array", "title": "Processing Errors" }, "uploaded_at": { "type": "string", "title": "Uploaded At" }, "processed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Processed At" } }, "type": "object", "required": [ "id", "engagement_id", "filename", "content_type", "document_category", "classification_status", "uploaded_at" ], "title": "Document", "description": "Uploaded document or reference architecture (Section 14.2.12)." }, "DocumentCategory": { "type": "string", "enum": [ "STRATEGIC", "TECHNICAL_ARCHITECTURE", "DATA_ASSETS", "SECURITY_COMPLIANCE", "FINANCIAL", "OPERATIONAL", "ORGANIZATIONAL", "VENDOR_PARTNER", "DEVELOPER_EXPERIENCE", "EXISTING_AI_ARTIFACTS", "REFERENCE_ARCHITECTURE" ], "title": "DocumentCategory" }, "DocumentRead": { "properties": { "id": { "type": "string", "title": "Id" }, "engagement_id": { "type": "string", "title": "Engagement Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "filename": { "type": "string", "title": "Filename" }, "content_type": { "type": "string", "title": "Content Type" }, "document_category": { "type": "string", "title": "Document Category" }, "classification_status": { "type": "string", "title": "Classification Status" }, "extracted_requirement_ids": { "items": { "type": "string" }, "type": "array", "title": "Extracted Requirement Ids" }, "processing_errors": { "items": { "type": "string" }, "type": "array", "title": "Processing Errors" }, "uploaded_at": { "type": "string", "format": "date-time", "title": "Uploaded At" }, "processed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Processed At" } }, "type": "object", "required": [ "id", "engagement_id", "session_id", "filename", "content_type", "document_category", "classification_status", "extracted_requirement_ids", "processing_errors", "uploaded_at", "processed_at" ], "title": "DocumentRead" }, "DomainMaturityScoreCreate": { "properties": { "domain_name": { "type": "string", "title": "Domain Name" }, "completion_pct": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Completion Pct", "default": 0.0 }, "confidence_score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence Score", "default": 0.0 }, "questions_total": { "type": "integer", "title": "Questions Total", "default": 0 }, "questions_answered": { "type": "integer", "title": "Questions Answered", "default": 0 }, "questions_skipped": { "type": "integer", "title": "Questions Skipped", "default": 0 }, "questions_delegated": { "type": "integer", "title": "Questions Delegated", "default": 0 }, "evidence_uploads": { "type": "integer", "title": "Evidence Uploads", "default": 0 }, "status": { "type": "string", "title": "Status", "default": "NOT_STARTED" } }, "type": "object", "required": [ "domain_name" ], "title": "DomainMaturityScoreCreate" }, "DomainMaturityScoreRead": { "properties": { "id": { "type": "string", "title": "Id" }, "session_id": { "type": "string", "title": "Session Id" }, "domain_name": { "type": "string", "title": "Domain Name" }, "completion_pct": { "type": "number", "title": "Completion Pct" }, "confidence_score": { "type": "number", "title": "Confidence Score" }, "questions_total": { "type": "integer", "title": "Questions Total" }, "questions_answered": { "type": "integer", "title": "Questions Answered" }, "questions_skipped": { "type": "integer", "title": "Questions Skipped" }, "questions_delegated": { "type": "integer", "title": "Questions Delegated" }, "evidence_uploads": { "type": "integer", "title": "Evidence Uploads" }, "gaps_detected": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Gaps Detected" }, "status": { "type": "string", "title": "Status" }, "last_updated": { "type": "string", "format": "date-time", "title": "Last Updated" } }, "type": "object", "required": [ "id", "session_id", "domain_name", "completion_pct", "confidence_score", "questions_total", "questions_answered", "questions_skipped", "questions_delegated", "evidence_uploads", "gaps_detected", "status", "last_updated" ], "title": "DomainMaturityScoreRead" }, "DomainMaturityScoreUpdate": { "properties": { "completion_pct": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Completion Pct" }, "confidence_score": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence Score" }, "questions_total": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Questions Total" }, "questions_answered": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Questions Answered" }, "questions_skipped": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Questions Skipped" }, "questions_delegated": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Questions Delegated" }, "evidence_uploads": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Evidence Uploads" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "gaps_detected": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Gaps Detected" } }, "type": "object", "title": "DomainMaturityScoreUpdate" }, "DomainOwnership": { "properties": { "domain": { "type": "string", "title": "Domain" }, "primary_owner": { "$ref": "#/components/schemas/Persona" }, "ownership_weight": { "type": "number", "title": "Ownership Weight" }, "secondary_contributors": { "items": { "$ref": "#/components/schemas/Persona" }, "type": "array", "title": "Secondary Contributors", "default": [] } }, "type": "object", "required": [ "domain", "primary_owner", "ownership_weight" ], "title": "DomainOwnership", "description": "Maps a domain to its owner for priority weighting (Section 5.4)." }, "DomainPreference": { "properties": { "ref_arch_type": { "$ref": "#/components/schemas/RefArchType" }, "capability_domain": { "type": "string", "title": "Capability Domain" }, "priority": { "type": "string", "enum": [ "P0", "P1", "P2", "P3" ], "title": "Priority" }, "prioritized_by": { "$ref": "#/components/schemas/Persona" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "ref_arch_type", "capability_domain", "priority", "prioritized_by" ], "title": "DomainPreference", "description": "Vision Track executive preference for a capability domain." }, "DomainReqs": { "properties": { "domain_name": { "type": "string", "title": "Domain Name" }, "persona": { "$ref": "#/components/schemas/Persona" }, "requirement_ids": { "items": { "type": "string" }, "type": "array", "title": "Requirement Ids", "default": [] }, "constraints": { "items": { "type": "string" }, "type": "array", "title": "Constraints", "default": [] }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" } }, "type": "object", "required": [ "domain_name", "persona" ], "title": "DomainReqs", "description": "Per-domain requirements for one persona domain." }, "EngagementCreate": { "properties": { "client_id": { "type": "string", "title": "Client Id" }, "organization_name": { "type": "string", "title": "Organization Name" }, "package_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Package Id" } }, "type": "object", "required": [ "client_id", "organization_name" ], "title": "EngagementCreate" }, "EngagementPackageCreate": { "properties": { "package_type": { "type": "string", "title": "Package Type", "default": "BASE" }, "purchased_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Purchased At" }, "activated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Activated At" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "token_budget": { "additionalProperties": true, "type": "object", "title": "Token Budget" }, "feature_limits": { "additionalProperties": true, "type": "object", "title": "Feature Limits" }, "billing_status": { "type": "string", "title": "Billing Status", "default": "ACTIVE" }, "payment_method_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Payment Method Id" } }, "type": "object", "title": "EngagementPackageCreate" }, "EngagementPackageRead": { "properties": { "id": { "type": "string", "title": "Id" }, "client_id": { "type": "string", "title": "Client Id" }, "package_type": { "type": "string", "title": "Package Type" }, "purchased_at": { "type": "string", "format": "date-time", "title": "Purchased At" }, "activated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Activated At" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "token_budget": { "additionalProperties": true, "type": "object", "title": "Token Budget" }, "feature_limits": { "additionalProperties": true, "type": "object", "title": "Feature Limits" }, "billing_status": { "type": "string", "title": "Billing Status" } }, "type": "object", "required": [ "id", "client_id", "package_type", "purchased_at", "activated_at", "expires_at", "token_budget", "feature_limits", "billing_status" ], "title": "EngagementPackageRead" }, "EngagementPackageUpdate": { "properties": { "package_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Package Type" }, "activated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Activated At" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "token_budget": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Token Budget" }, "feature_limits": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Feature Limits" }, "billing_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Billing Status" }, "upgraded_to_usage_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Upgraded To Usage At" }, "payment_method_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Payment Method Id" } }, "type": "object", "title": "EngagementPackageUpdate" }, "EngagementRead": { "properties": { "id": { "type": "string", "title": "Id" }, "client_id": { "type": "string", "title": "Client Id" }, "organization_name": { "type": "string", "title": "Organization Name" }, "status": { "type": "string", "title": "Status" }, "package_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Package Id" }, "started_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Started At" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "client_id", "organization_name", "status", "package_id", "started_at", "expires_at", "created_at", "updated_at" ], "title": "EngagementRead" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "Metric": { "properties": { "name": { "type": "string", "title": "Name" }, "target": { "type": "string", "title": "Target" }, "measurement_approach": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measurement Approach" } }, "type": "object", "required": [ "name", "target" ], "title": "Metric", "description": "Success criteria for measuring outcomes." }, "Milestone": { "properties": { "name": { "type": "string", "title": "Name" }, "target_date": { "type": "string", "title": "Target Date" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "required": [ "name", "target_date" ], "title": "Milestone", "description": "Timeline milestone." }, "Money": { "properties": { "amount": { "type": "number", "title": "Amount" }, "currency": { "type": "string", "title": "Currency" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope" } }, "type": "object", "required": [ "amount", "currency" ], "title": "Money", "description": "Budget envelope for resource constraints." }, "Objective": { "properties": { "id": { "type": "string", "title": "Id" }, "description": { "type": "string", "title": "Description" }, "priority": { "$ref": "#/components/schemas/PriorityShort" }, "strategic_objective_ids": { "items": { "type": "string" }, "type": "array", "title": "Strategic Objective Ids" }, "source_persona": { "$ref": "#/components/schemas/Persona" } }, "type": "object", "required": [ "id", "description", "priority", "strategic_objective_ids", "source_persona" ], "title": "Objective", "description": "Prioritized business objective in strategic context." }, "Persona": { "type": "string", "enum": [ "CEO", "CFO", "CDO", "CTO", "CISO", "CHIEF_ARCHITECT", "VP_INFRA", "VP_APP_DEV", "COO" ], "title": "Persona" }, "PersonaPriorityInput": { "properties": { "persona": { "$ref": "#/components/schemas/Persona" }, "priority": { "$ref": "#/components/schemas/Priority" }, "priority_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Priority Weight" }, "is_domain_owner": { "type": "boolean", "title": "Is Domain Owner" }, "ownership_weight": { "type": "number", "title": "Ownership Weight" }, "rationale": { "type": "string", "title": "Rationale" }, "timestamp": { "type": "string", "title": "Timestamp" }, "interview_session_id": { "type": "string", "title": "Interview Session Id" } }, "type": "object", "required": [ "persona", "priority", "priority_weight", "is_domain_owner", "ownership_weight", "rationale", "timestamp", "interview_session_id" ], "title": "PersonaPriorityInput", "description": "Individual persona priority assessment for domain ownership weighting (Section 14.1.2, 5.4)." }, "Priority": { "type": "string", "enum": [ "P0_NON_NEGOTIABLE", "P1_CRITICAL", "P2_IMPORTANT", "P3_PREFERRED" ], "title": "Priority" }, "PriorityShort": { "type": "string", "enum": [ "P0", "P1", "P2", "P3" ], "title": "PriorityShort" }, "PrioritySource": { "type": "string", "enum": [ "DOMAIN_OWNER", "CONSTRAINT_DERIVED", "CEO_RANKED", "CONFLICT_RESOLVED" ], "title": "PrioritySource" }, "QuestionCreate": { "properties": { "module_domain": { "type": "string", "title": "Module Domain" }, "question_text": { "type": "string", "title": "Question Text" }, "question_type": { "$ref": "#/components/schemas/QuestionType" }, "order_index": { "type": "integer", "title": "Order Index", "default": 0 }, "source_question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Question Id" }, "adaptive_trigger": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adaptive Trigger" } }, "type": "object", "required": [ "module_domain", "question_text", "question_type" ], "title": "QuestionCreate" }, "QuestionRead": { "properties": { "id": { "type": "string", "title": "Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "module_domain": { "type": "string", "title": "Module Domain" }, "question_text": { "type": "string", "title": "Question Text" }, "question_type": { "type": "string", "title": "Question Type" }, "order_index": { "type": "integer", "title": "Order Index" }, "source_question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Question Id" }, "adaptive_trigger": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adaptive Trigger" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "session_id", "module_domain", "question_text", "question_type", "order_index", "source_question_id", "adaptive_trigger", "created_at" ], "title": "QuestionRead" }, "QuestionType": { "type": "string", "enum": [ "MANDATORY", "CONTEXTUAL", "DEEP_DIVE", "FOLLOW_UP" ], "title": "QuestionType" }, "QuestionUpdate": { "properties": { "module_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Module Domain" }, "question_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Text" }, "question_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Type" }, "order_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Order Index" }, "source_question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Question Id" }, "adaptive_trigger": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adaptive Trigger" } }, "type": "object", "title": "QuestionUpdate" }, "RefArchMaturityAssessment": { "properties": { "ref_arch_type": { "$ref": "#/components/schemas/RefArchType" }, "capability_domain": { "type": "string", "title": "Capability Domain" }, "current_maturity": { "type": "integer", "title": "Current Maturity" }, "target_maturity": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Target Maturity" }, "existing_tools": { "items": { "type": "string" }, "type": "array", "title": "Existing Tools", "default": [] }, "known_gaps": { "items": { "type": "string" }, "type": "array", "title": "Known Gaps", "default": [] }, "priority_for_strategy": { "type": "string", "enum": [ "P0", "P1", "P2", "P3", "NOT_APPLICABLE" ], "title": "Priority For Strategy" }, "assessed_by": { "$ref": "#/components/schemas/Persona" }, "assessment_confidence": { "type": "string", "enum": [ "HIGH", "MEDIUM", "LOW" ], "title": "Assessment Confidence" }, "timestamp": { "type": "string", "title": "Timestamp" } }, "type": "object", "required": [ "ref_arch_type", "capability_domain", "current_maturity", "priority_for_strategy", "assessed_by", "assessment_confidence", "timestamp" ], "title": "RefArchMaturityAssessment", "description": "Per-domain maturity self-assessment from Execution Track technical leaders." }, "RefArchType": { "type": "string", "enum": [ "PLATFORM", "DEVELOPER", "APPLICATION" ], "title": "RefArchType" }, "ReferenceArchitectureContext": { "properties": { "ref_arch_source": { "type": "string", "enum": [ "CLIENT_PROVIDED", "PLATFORM_DEFAULT", "HYBRID" ], "title": "Ref Arch Source" }, "client_ref_archs": { "items": { "$ref": "#/components/schemas/Document" }, "type": "array", "title": "Client Ref Archs", "default": [] }, "platform_ref_archs_used": { "items": { "type": "string" }, "type": "array", "title": "Platform Ref Archs Used", "default": [] }, "capability_domains_prioritized": { "items": { "$ref": "#/components/schemas/CapabilityDomainPriority" }, "type": "array", "title": "Capability Domains Prioritized", "default": [] }, "maturity_assessments": { "items": { "$ref": "#/components/schemas/RefArchMaturityAssessment" }, "type": "array", "title": "Maturity Assessments", "default": [] }, "capability_gaps": { "items": { "$ref": "#/components/schemas/CapabilityGap" }, "type": "array", "title": "Capability Gaps", "default": [] }, "executive_domain_preferences": { "items": { "$ref": "#/components/schemas/DomainPreference" }, "type": "array", "title": "Executive Domain Preferences", "default": [] } }, "type": "object", "required": [ "ref_arch_source" ], "title": "ReferenceArchitectureContext", "description": "Reference architecture context." }, "ReminderRead": { "properties": { "id": { "type": "string", "title": "Id" }, "reminder_type": { "type": "string", "title": "Reminder Type" }, "sent_at": { "type": "string", "format": "date-time", "title": "Sent At" }, "recipient": { "type": "string", "title": "Recipient" }, "related_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Related Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, "type": "object", "required": [ "id", "reminder_type", "sent_at", "recipient", "related_id", "session_id" ], "title": "ReminderRead" }, "RequirementCreate": { "properties": { "source_persona": { "type": "string", "title": "Source Persona" }, "source_type": { "type": "string", "title": "Source Type" }, "source_document": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Document" }, "tier": { "type": "string", "title": "Tier" }, "domain_area": { "type": "string", "title": "Domain Area" }, "domain_owner": { "type": "string", "title": "Domain Owner" }, "classification": { "type": "string", "title": "Classification" }, "constraint_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Constraint Type" }, "priority": { "type": "string", "title": "Priority" }, "priority_weight": { "type": "number", "title": "Priority Weight", "default": 0.5 }, "priority_source": { "type": "string", "title": "Priority Source" }, "priority_rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority Rationale" }, "strategic_alignment": { "items": { "type": "string" }, "type": "array", "title": "Strategic Alignment", "default": [] }, "priority_contributors": { "items": {}, "type": "array", "title": "Priority Contributors", "default": [] }, "content": { "type": "string", "title": "Content" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "validation_status": { "type": "string", "title": "Validation Status", "default": "UNVALIDATED" }, "confidence": { "type": "number", "title": "Confidence", "default": 1.0 }, "cross_references": { "items": { "type": "string" }, "type": "array", "title": "Cross References", "default": [] }, "conflicts_with": { "items": { "type": "string" }, "type": "array", "title": "Conflicts With", "default": [] } }, "type": "object", "required": [ "source_persona", "source_type", "tier", "domain_area", "domain_owner", "classification", "priority", "priority_source", "content" ], "title": "RequirementCreate", "description": "Server will set id, created_at, updated_at, version, change_history." }, "RequirementItem": { "properties": { "id": { "type": "string", "title": "Id" }, "source_persona": { "$ref": "#/components/schemas/Persona" }, "source_type": { "$ref": "#/components/schemas/SourceType" }, "source_document": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Document" }, "tier": { "$ref": "#/components/schemas/Tier" }, "domain_area": { "type": "string", "title": "Domain Area" }, "domain_owner": { "$ref": "#/components/schemas/Persona" }, "classification": { "$ref": "#/components/schemas/Classification" }, "constraint_type": { "anyOf": [ { "$ref": "#/components/schemas/ConstraintType" }, { "type": "null" } ] }, "priority": { "$ref": "#/components/schemas/Priority" }, "priority_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Priority Weight" }, "priority_source": { "$ref": "#/components/schemas/PrioritySource" }, "priority_rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority Rationale" }, "strategic_alignment": { "items": { "type": "string" }, "type": "array", "title": "Strategic Alignment" }, "priority_contributors": { "items": { "$ref": "#/components/schemas/PersonaPriorityInput" }, "type": "array", "title": "Priority Contributors" }, "content": { "type": "string", "title": "Content" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "validation_status": { "$ref": "#/components/schemas/ValidationStatus" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence" }, "cross_references": { "items": { "type": "string" }, "type": "array", "title": "Cross References" }, "conflicts_with": { "items": { "type": "string" }, "type": "array", "title": "Conflicts With" }, "created_at": { "type": "string", "title": "Created At" }, "updated_at": { "type": "string", "title": "Updated At" }, "version": { "type": "integer", "title": "Version" }, "change_history": { "items": { "$ref": "#/components/schemas/AuditEntry" }, "type": "array", "title": "Change History" } }, "type": "object", "required": [ "id", "source_persona", "source_type", "tier", "domain_area", "domain_owner", "classification", "priority", "priority_weight", "priority_source", "content", "validation_status", "confidence", "created_at", "updated_at", "version" ], "title": "RequirementItem", "description": "Every piece of information captured through interviews or document analysis (Section 14.1.1)." }, "RequirementUpdate": { "properties": { "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority" }, "priority_weight": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Priority Weight" }, "priority_rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority Rationale" }, "validation_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Validation Status" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" } }, "type": "object", "title": "RequirementUpdate" }, "ResearchAgentInputPackage": { "properties": { "metadata": { "$ref": "#/components/schemas/ResearchAgentInputPackageMetadata" }, "strategic_context": { "$ref": "#/components/schemas/ResearchAgentInputPackageStrategicContext" }, "constraints": { "$ref": "#/components/schemas/ResearchAgentInputPackageConstraints" }, "domain_requirements": { "$ref": "#/components/schemas/ResearchAgentInputPackageDomainRequirements" }, "priority_context": { "$ref": "#/components/schemas/ResearchAgentInputPackagePriorityContext" }, "cross_references": { "items": { "$ref": "#/components/schemas/XRef" }, "type": "array", "title": "Cross References", "default": [] }, "traceability_matrix": { "items": { "$ref": "#/components/schemas/Trace" }, "type": "array", "title": "Traceability Matrix", "default": [] }, "reference_architecture_context": { "$ref": "#/components/schemas/ReferenceArchitectureContext" }, "supporting_documents": { "$ref": "#/components/schemas/SupportingDocuments" } }, "type": "object", "required": [ "metadata", "strategic_context", "constraints", "domain_requirements", "priority_context", "reference_architecture_context", "supporting_documents" ], "title": "ResearchAgentInputPackage", "description": "Full handoff package: output of intake system, input to research engine (Section 14.7.1)." }, "ResearchAgentInputPackageConstraints": { "properties": { "regulatory": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Regulatory", "default": [] }, "contractual": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Contractual", "default": [] }, "security": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Security", "default": [] }, "financial": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Financial", "default": [] }, "organizational": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Organizational", "default": [] }, "technical": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Technical", "default": [] }, "operational": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Operational", "default": [] }, "preferences": { "items": { "$ref": "#/components/schemas/Constraint" }, "type": "array", "title": "Preferences", "default": [] } }, "type": "object", "title": "ResearchAgentInputPackageConstraints", "description": "Constraints grouped by type (P0\u2013P3)." }, "ResearchAgentInputPackageDomainRequirements": { "properties": { "business_strategy": { "$ref": "#/components/schemas/DomainReqs" }, "financial_strategy": { "$ref": "#/components/schemas/DomainReqs" }, "data_strategy": { "$ref": "#/components/schemas/DomainReqs" }, "technology_strategy": { "$ref": "#/components/schemas/DomainReqs" }, "security_strategy": { "$ref": "#/components/schemas/DomainReqs" }, "architecture_patterns": { "$ref": "#/components/schemas/DomainReqs" }, "infrastructure_ops": { "$ref": "#/components/schemas/DomainReqs" }, "application_delivery": { "$ref": "#/components/schemas/DomainReqs" }, "operational_processes": { "$ref": "#/components/schemas/DomainReqs" } }, "type": "object", "required": [ "business_strategy", "financial_strategy", "data_strategy", "technology_strategy", "security_strategy", "architecture_patterns", "infrastructure_ops", "application_delivery", "operational_processes" ], "title": "ResearchAgentInputPackageDomainRequirements", "description": "Domain requirements per persona domain." }, "ResearchAgentInputPackageMetadata": { "properties": { "organization": { "type": "string", "title": "Organization" }, "engagement_id": { "type": "string", "title": "Engagement Id" }, "corpus_version": { "type": "integer", "title": "Corpus Version" }, "sign_off_chain": { "items": { "$ref": "#/components/schemas/SignOff" }, "type": "array", "title": "Sign Off Chain" } }, "type": "object", "required": [ "organization", "engagement_id", "corpus_version", "sign_off_chain" ], "title": "ResearchAgentInputPackageMetadata", "description": "Metadata for the handoff package." }, "ResearchAgentInputPackagePriorityContext": { "properties": { "strategic_objectives": { "items": { "$ref": "#/components/schemas/StrategicObjective" }, "type": "array", "title": "Strategic Objectives" }, "p0_constraints": { "items": { "$ref": "#/components/schemas/RequirementItem" }, "type": "array", "title": "P0 Constraints" }, "p1_requirements": { "items": { "$ref": "#/components/schemas/RequirementItem" }, "type": "array", "title": "P1 Requirements" }, "priority_conflicts_resolved": { "items": { "$ref": "#/components/schemas/ConflictResolution" }, "type": "array", "title": "Priority Conflicts Resolved" }, "domain_ownership_map": { "items": { "$ref": "#/components/schemas/DomainOwnership" }, "type": "array", "title": "Domain Ownership Map" }, "resource_constraints": { "$ref": "#/components/schemas/ResourceConstraints" } }, "type": "object", "required": [ "strategic_objectives", "p0_constraints", "p1_requirements", "priority_conflicts_resolved", "domain_ownership_map", "resource_constraints" ], "title": "ResearchAgentInputPackagePriorityContext", "description": "Priority context for the research engine." }, "ResearchAgentInputPackageStrategicContext": { "properties": { "vision_statement": { "type": "string", "title": "Vision Statement" }, "business_objectives": { "items": { "$ref": "#/components/schemas/Objective" }, "type": "array", "title": "Business Objectives" }, "risk_tolerance": { "$ref": "#/components/schemas/RiskProfile" }, "timeline": { "$ref": "#/components/schemas/Timeline" }, "success_criteria": { "items": { "$ref": "#/components/schemas/Metric" }, "type": "array", "title": "Success Criteria" } }, "type": "object", "required": [ "vision_statement", "business_objectives", "risk_tolerance", "timeline", "success_criteria" ], "title": "ResearchAgentInputPackageStrategicContext", "description": "Strategic context for the research engine." }, "Resolution": { "properties": { "id": { "type": "string", "title": "Id" }, "conflict_resolution_id": { "type": "string", "title": "Conflict Resolution Id" }, "requirement_ids_involved": { "items": { "type": "string" }, "type": "array", "title": "Requirement Ids Involved", "default": [] }, "resolution_type": { "$ref": "#/components/schemas/ConflictType" }, "outcome": { "type": "string", "title": "Outcome" }, "resolved_at": { "type": "string", "title": "Resolved At" }, "audit_entry_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audit Entry Id" } }, "type": "object", "required": [ "id", "conflict_resolution_id", "resolution_type", "outcome", "resolved_at" ], "title": "Resolution", "description": "Conflict resolution record for handoff." }, "ResolutionMethod": { "type": "string", "enum": [ "DOMAIN_OWNER", "CEO_ALIGNMENT", "WEIGHTED_CONSENSUS", "HUMAN_MEDIATION" ], "title": "ResolutionMethod" }, "ResourceConstraints": { "properties": { "budget_envelope": { "$ref": "#/components/schemas/Money" }, "timeline_constraints": { "$ref": "#/components/schemas/Timeline" }, "team_capacity": { "$ref": "#/components/schemas/TeamCapacity" } }, "type": "object", "required": [ "budget_envelope", "timeline_constraints", "team_capacity" ], "title": "ResourceConstraints", "description": "Resource constraints (budget, timeline, team)." }, "ResponseCreate": { "properties": { "question_id": { "type": "string", "title": "Question Id" }, "content": { "type": "string", "title": "Content" }, "modality": { "anyOf": [ { "type": "string", "enum": [ "TEXT", "VISION", "VOICE" ] }, { "type": "null" } ], "title": "Modality" }, "source": { "type": "string", "enum": [ "DIRECT", "DELEGATION", "BULK_UPLOAD" ], "title": "Source", "default": "DIRECT" }, "answered_by": { "anyOf": [ { "$ref": "#/components/schemas/Persona" }, { "type": "null" } ] }, "delegation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Delegation Id" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence", "default": 1.0 } }, "type": "object", "required": [ "question_id", "content" ], "title": "ResponseCreate" }, "ResponseRead": { "properties": { "id": { "type": "string", "title": "Id" }, "session_id": { "type": "string", "title": "Session Id" }, "question_id": { "type": "string", "title": "Question Id" }, "content": { "type": "string", "title": "Content" }, "modality": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Modality" }, "source": { "type": "string", "title": "Source" }, "answered_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Answered By" }, "delegation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Delegation Id" }, "confidence": { "type": "number", "title": "Confidence" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" } }, "type": "object", "required": [ "id", "session_id", "question_id", "content", "modality", "source", "answered_by", "delegation_id", "confidence", "created_at", "updated_at" ], "title": "ResponseRead" }, "ResponseUpdate": { "properties": { "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "modality": { "anyOf": [ { "type": "string", "enum": [ "TEXT", "VISION", "VOICE" ] }, { "type": "null" } ], "title": "Modality" }, "source": { "anyOf": [ { "type": "string", "enum": [ "DIRECT", "DELEGATION", "BULK_UPLOAD" ] }, { "type": "null" } ], "title": "Source" }, "answered_by": { "anyOf": [ { "$ref": "#/components/schemas/Persona" }, { "type": "null" } ] }, "delegation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Delegation Id" }, "confidence": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence" } }, "type": "object", "title": "ResponseUpdate", "description": "Optional fields for PATCH; only provided fields are updated." }, "RiskAppetite": { "type": "string", "enum": [ "CONSERVATIVE", "MODERATE", "AGGRESSIVE" ], "title": "RiskAppetite" }, "RiskProfile": { "properties": { "risk_appetite": { "$ref": "#/components/schemas/RiskAppetite" }, "compliance_priorities": { "items": { "type": "string" }, "type": "array", "title": "Compliance Priorities", "default": [] }, "tolerance_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tolerance Notes" } }, "type": "object", "required": [ "risk_appetite" ], "title": "RiskProfile", "description": "Organizational risk tolerance for the research engine." }, "Session": { "properties": { "session_id": { "type": "string", "title": "Session Id" }, "persona": { "$ref": "#/components/schemas/Persona" }, "tier": { "$ref": "#/components/schemas/Tier" }, "status": { "type": "string", "title": "Status" }, "requirement_ids": { "items": { "type": "string" }, "type": "array", "title": "Requirement Ids", "default": [] }, "summary_ids": { "items": { "type": "string" }, "type": "array", "title": "Summary Ids", "default": [] }, "completed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Completed At" } }, "type": "object", "required": [ "session_id", "persona", "tier", "status" ], "title": "Session", "description": "Subset of session data for the research engine." }, "SessionCreate": { "properties": { "persona": { "$ref": "#/components/schemas/Persona" }, "tier": { "$ref": "#/components/schemas/Tier" }, "session_type": { "$ref": "#/components/schemas/SessionType", "default": "INITIAL" }, "user_track": { "$ref": "#/components/schemas/UserTrack", "default": "VISION_TRACK" } }, "type": "object", "required": [ "persona", "tier" ], "title": "SessionCreate" }, "SessionRead": { "properties": { "id": { "type": "string", "title": "Id" }, "engagement_id": { "type": "string", "title": "Engagement Id" }, "persona": { "type": "string", "title": "Persona" }, "tier": { "type": "string", "title": "Tier" }, "session_type": { "type": "string", "title": "Session Type" }, "status": { "type": "string", "title": "Status" }, "user_track": { "type": "string", "title": "User Track" }, "started_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Started At" }, "completed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Completed At" }, "paused_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Paused At" }, "last_activity_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Activity At" }, "reviewed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Reviewed At" }, "reviewer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewer" }, "review_decision": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Review Decision" }, "review_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Review Notes" }, "current_question_index": { "type": "integer", "title": "Current Question Index", "default": 0 }, "parent_session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Session Id" }, "resume_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Token" }, "tokens_consumed": { "type": "integer", "title": "Tokens Consumed", "default": 0 }, "session_cost_multiplier": { "type": "number", "title": "Session Cost Multiplier", "default": 1.0 }, "is_counted_as_revisit": { "type": "boolean", "title": "Is Counted As Revisit", "default": false }, "revisit_weight": { "type": "number", "title": "Revisit Weight", "default": 0.0 }, "created_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Created At" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" } }, "type": "object", "required": [ "id", "engagement_id", "persona", "tier", "session_type", "status", "user_track" ], "title": "SessionRead", "description": "Session response aligned to Section 14.2.1 (core + optional extended fields)." }, "SessionType": { "type": "string", "enum": [ "INITIAL", "REVISIT", "FOLLOW_UP", "MEDIATION" ], "title": "SessionType" }, "SessionUpdate": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "current_question_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Question Index" }, "paused_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Paused At" }, "last_activity_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Activity At" }, "review_decision": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Review Decision" }, "review_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Review Notes" }, "resume_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Token" }, "parent_session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Session Id" }, "tokens_consumed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Tokens Consumed" }, "session_cost_multiplier": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Session Cost Multiplier" }, "is_counted_as_revisit": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Counted As Revisit" }, "revisit_weight": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Revisit Weight" } }, "type": "object", "title": "SessionUpdate" }, "SignOff": { "properties": { "id": { "type": "string", "title": "Id" }, "actor": { "$ref": "#/components/schemas/Persona" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "timestamp": { "type": "string", "title": "Timestamp" }, "checkpoint": { "$ref": "#/components/schemas/Checkpoint" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "corpus_version": { "type": "integer", "title": "Corpus Version" }, "engagement_id": { "type": "string", "title": "Engagement Id" } }, "type": "object", "required": [ "id", "actor", "timestamp", "checkpoint", "corpus_version", "engagement_id" ], "title": "SignOff", "description": "Checkpoint approval record for handoff chain (Section 14.8.2)." }, "SignOffCreate": { "properties": { "checkpoint": { "$ref": "#/components/schemas/Checkpoint" }, "actor": { "$ref": "#/components/schemas/Persona" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "corpus_version": { "type": "integer", "title": "Corpus Version", "default": 1 } }, "type": "object", "required": [ "checkpoint", "actor" ], "title": "SignOffCreate" }, "SourceType": { "type": "string", "enum": [ "INTERVIEW", "DOCUMENT", "CONFLICT_RESOLUTION", "FOLLOW_UP" ], "title": "SourceType" }, "StrategicObjective": { "properties": { "id": { "type": "string", "title": "Id" }, "description": { "type": "string", "title": "Description" }, "rank": { "type": "integer", "title": "Rank" }, "weight": { "type": "number", "title": "Weight" }, "success_criteria": { "items": { "type": "string" }, "type": "array", "title": "Success Criteria" }, "related_requirements": { "items": { "type": "string" }, "type": "array", "title": "Related Requirements" }, "conflicts_with": { "items": { "type": "string" }, "type": "array", "title": "Conflicts With" }, "assigned_tier": { "$ref": "#/components/schemas/Tier" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "description", "rank", "weight", "assigned_tier", "created_at" ], "title": "StrategicObjective", "description": "CEO-ranked business objectives from the strategic priority ranking exercise (Section 14.1.3, 6.1)." }, "StrategicObjectiveCreate": { "properties": { "description": { "type": "string", "title": "Description" }, "rank": { "type": "integer", "title": "Rank" }, "weight": { "type": "number", "title": "Weight" }, "success_criteria": { "items": { "type": "string" }, "type": "array", "title": "Success Criteria" }, "related_requirements": { "items": { "type": "string" }, "type": "array", "title": "Related Requirements" }, "conflicts_with": { "items": { "type": "string" }, "type": "array", "title": "Conflicts With" }, "assigned_tier": { "$ref": "#/components/schemas/Tier" } }, "type": "object", "required": [ "description", "rank", "weight", "assigned_tier" ], "title": "StrategicObjectiveCreate" }, "StrategicObjectiveRead": { "properties": { "id": { "type": "string", "title": "Id" }, "engagement_id": { "type": "string", "title": "Engagement Id" }, "description": { "type": "string", "title": "Description" }, "rank": { "type": "integer", "title": "Rank" }, "weight": { "type": "number", "title": "Weight" }, "success_criteria": { "items": { "type": "string" }, "type": "array", "title": "Success Criteria" }, "related_requirements": { "items": { "type": "string" }, "type": "array", "title": "Related Requirements" }, "conflicts_with": { "items": { "type": "string" }, "type": "array", "title": "Conflicts With" }, "assigned_tier": { "type": "string", "title": "Assigned Tier" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "engagement_id", "description", "rank", "weight", "success_criteria", "related_requirements", "conflicts_with", "assigned_tier", "created_at" ], "title": "StrategicObjectiveRead" }, "StrategicObjectiveUpdate": { "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Rank" }, "weight": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Weight" }, "success_criteria": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Success Criteria" }, "related_requirements": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Related Requirements" }, "conflicts_with": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Conflicts With" }, "assigned_tier": { "anyOf": [ { "$ref": "#/components/schemas/Tier" }, { "type": "null" } ] } }, "type": "object", "title": "StrategicObjectiveUpdate" }, "SummaryCreate": { "properties": { "domain_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain Name" }, "version": { "type": "integer", "title": "Version", "default": 1 }, "status": { "type": "string", "title": "Status", "default": "DRAFT" }, "key_insights": { "items": { "type": "string" }, "type": "array", "title": "Key Insights" }, "constraints_identified": { "items": { "type": "string" }, "type": "array", "title": "Constraints Identified" }, "dependencies": { "items": { "type": "string" }, "type": "array", "title": "Dependencies" }, "confidence_score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence Score", "default": 0.0 }, "refinement_notes": { "items": { "type": "string" }, "type": "array", "title": "Refinement Notes" } }, "type": "object", "title": "SummaryCreate" }, "SummaryRead": { "properties": { "summary_id": { "type": "string", "title": "Summary Id" }, "session_id": { "type": "string", "title": "Session Id" }, "domain_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain Name" }, "version": { "type": "integer", "title": "Version" }, "generated_at": { "type": "string", "format": "date-time", "title": "Generated At" }, "status": { "type": "string", "title": "Status" }, "key_insights": { "items": { "type": "string" }, "type": "array", "title": "Key Insights" }, "constraints_identified": { "items": { "type": "string" }, "type": "array", "title": "Constraints Identified" }, "dependencies": { "items": { "type": "string" }, "type": "array", "title": "Dependencies" }, "confidence_score": { "type": "number", "title": "Confidence Score" }, "approved_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Approved At" }, "refinement_notes": { "items": { "type": "string" }, "type": "array", "title": "Refinement Notes" } }, "type": "object", "required": [ "summary_id", "session_id", "domain_name", "version", "generated_at", "status", "key_insights", "constraints_identified", "dependencies", "confidence_score", "approved_at", "refinement_notes" ], "title": "SummaryRead" }, "SummaryUpdate": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "key_insights": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Key Insights" }, "constraints_identified": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Constraints Identified" }, "dependencies": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Dependencies" }, "confidence_score": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence Score" }, "refinement_notes": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Refinement Notes" }, "approved_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Approved At" } }, "type": "object", "title": "SummaryUpdate" }, "SupportingDocuments": { "properties": { "uploaded_docs": { "items": { "$ref": "#/components/schemas/Document" }, "type": "array", "title": "Uploaded Docs", "default": [] }, "interview_records": { "items": { "$ref": "#/components/schemas/Session" }, "type": "array", "title": "Interview Records", "default": [] }, "conflict_resolutions": { "items": { "$ref": "#/components/schemas/Resolution" }, "type": "array", "title": "Conflict Resolutions", "default": [] } }, "type": "object", "title": "SupportingDocuments", "description": "Supporting documents and records." }, "TaggedDelegateCreate": { "properties": { "question_id": { "type": "string", "title": "Question Id" }, "delegate_email": { "type": "string", "title": "Delegate Email" }, "delegate_persona": { "anyOf": [ { "$ref": "#/components/schemas/Persona" }, { "type": "null" } ] }, "deadline": { "type": "string", "format": "date-time", "title": "Deadline" }, "context_note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context Note" } }, "type": "object", "required": [ "question_id", "delegate_email", "deadline" ], "title": "TaggedDelegateCreate" }, "TaggedDelegateRead": { "properties": { "delegation_id": { "type": "string", "title": "Delegation Id" }, "session_id": { "type": "string", "title": "Session Id" }, "question_id": { "type": "string", "title": "Question Id" }, "delegate_email": { "type": "string", "title": "Delegate Email" }, "delegate_persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Delegate Persona" }, "deadline": { "type": "string", "format": "date-time", "title": "Deadline" }, "context_note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context Note" }, "status": { "type": "string", "title": "Status" }, "delegated_at": { "type": "string", "format": "date-time", "title": "Delegated At" }, "responded_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Responded At" }, "response_content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Response Content" }, "response_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Response Confidence" }, "reminders_sent": { "type": "integer", "title": "Reminders Sent" } }, "type": "object", "required": [ "delegation_id", "session_id", "question_id", "delegate_email", "delegate_persona", "deadline", "context_note", "status", "delegated_at", "responded_at", "response_content", "response_confidence", "reminders_sent" ], "title": "TaggedDelegateRead" }, "TaggedDelegateUpdate": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "response_content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Response Content" }, "response_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Response Confidence" }, "responded_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Responded At" } }, "type": "object", "title": "TaggedDelegateUpdate" }, "TeamCapacity": { "properties": { "description": { "type": "string", "title": "Description" }, "team_size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Team Size" }, "constraints": { "items": { "type": "string" }, "type": "array", "title": "Constraints", "default": [] } }, "type": "object", "required": [ "description" ], "title": "TeamCapacity", "description": "Available team resources for the research engine." }, "Tier": { "type": "string", "enum": [ "TIER_1", "TIER_2", "TIER_3" ], "title": "Tier" }, "Timeline": { "properties": { "horizon": { "type": "string", "title": "Horizon" }, "milestones": { "items": { "$ref": "#/components/schemas/Milestone" }, "type": "array", "title": "Milestones", "default": [] }, "hard_deadlines": { "items": { "type": "string" }, "type": "array", "title": "Hard Deadlines", "default": [] } }, "type": "object", "required": [ "horizon" ], "title": "Timeline", "description": "Strategic timeline and milestones." }, "TokenUsageLogCreate": { "properties": { "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona" }, "operation_type": { "type": "string", "title": "Operation Type" }, "feature_category": { "type": "string", "title": "Feature Category" }, "tokens_consumed": { "type": "integer", "title": "Tokens Consumed", "default": 0 }, "cost_multiplier": { "type": "number", "title": "Cost Multiplier", "default": 1.0 }, "effective_cost": { "type": "integer", "title": "Effective Cost", "default": 0 }, "description": { "type": "string", "title": "Description", "default": "" }, "log_metadata": { "additionalProperties": true, "type": "object", "title": "Log Metadata" } }, "type": "object", "required": [ "operation_type", "feature_category" ], "title": "TokenUsageLogCreate" }, "TokenUsageLogRead": { "properties": { "id": { "type": "string", "title": "Id" }, "timestamp": { "type": "string", "format": "date-time", "title": "Timestamp" }, "client_id": { "type": "string", "title": "Client Id" }, "session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" }, "persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona" }, "operation_type": { "type": "string", "title": "Operation Type" }, "feature_category": { "type": "string", "title": "Feature Category" }, "tokens_consumed": { "type": "integer", "title": "Tokens Consumed" }, "cost_multiplier": { "type": "number", "title": "Cost Multiplier" }, "effective_cost": { "type": "integer", "title": "Effective Cost" }, "description": { "type": "string", "title": "Description" }, "log_metadata": { "additionalProperties": true, "type": "object", "title": "Log Metadata" } }, "type": "object", "required": [ "id", "timestamp", "client_id", "session_id", "persona", "operation_type", "feature_category", "tokens_consumed", "cost_multiplier", "effective_cost", "description" ], "title": "TokenUsageLogRead" }, "TokenUsageLogUpdate": { "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "log_metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Log Metadata" } }, "type": "object", "title": "TokenUsageLogUpdate" }, "Trace": { "properties": { "requirement_id": { "type": "string", "title": "Requirement Id" }, "source_persona": { "$ref": "#/components/schemas/Persona" }, "source_session_id": { "type": "string", "title": "Source Session Id" }, "source_document_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Document Id" }, "source_question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Question Id" } }, "type": "object", "required": [ "requirement_id", "source_persona", "source_session_id" ], "title": "Trace", "description": "Single row in the traceability matrix." }, "UsageAlertCreate": { "properties": { "alert_type": { "type": "string", "title": "Alert Type" }, "severity": { "type": "string", "title": "Severity", "default": "INFO" }, "title": { "type": "string", "title": "Title", "default": "" }, "message": { "type": "string", "title": "Message", "default": "" }, "recommended_action": { "type": "string", "title": "Recommended Action", "default": "" }, "upgrade_cta": { "type": "boolean", "title": "Upgrade Cta", "default": false }, "current_consumption": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Consumption" }, "limit_reached": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Limit Reached" }, "days_until_expiration": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Days Until Expiration" } }, "type": "object", "required": [ "alert_type" ], "title": "UsageAlertCreate" }, "UsageAlertRead": { "properties": { "id": { "type": "string", "title": "Id" }, "client_id": { "type": "string", "title": "Client Id" }, "alert_type": { "type": "string", "title": "Alert Type" }, "severity": { "type": "string", "title": "Severity" }, "triggered_at": { "type": "string", "format": "date-time", "title": "Triggered At" }, "acknowledged_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Acknowledged At" }, "title": { "type": "string", "title": "Title" }, "message": { "type": "string", "title": "Message" }, "recommended_action": { "type": "string", "title": "Recommended Action" }, "upgrade_cta": { "type": "boolean", "title": "Upgrade Cta" }, "current_consumption": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Consumption" }, "limit_reached": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Limit Reached" }, "days_until_expiration": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Days Until Expiration" } }, "type": "object", "required": [ "id", "client_id", "alert_type", "severity", "triggered_at", "acknowledged_at", "title", "message", "recommended_action", "upgrade_cta", "current_consumption", "limit_reached", "days_until_expiration" ], "title": "UsageAlertRead" }, "UsageAlertUpdate": { "properties": { "acknowledged_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Acknowledged At" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "recommended_action": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommended Action" }, "upgrade_cta": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Upgrade Cta" } }, "type": "object", "title": "UsageAlertUpdate" }, "UserTrack": { "type": "string", "enum": [ "VISION_TRACK", "EXECUTION_TRACK" ], "title": "UserTrack" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "ValidationStatus": { "type": "string", "enum": [ "UNVALIDATED", "VALIDATED", "CONFLICTED", "SUPERSEDED" ], "title": "ValidationStatus" }, "XRef": { "properties": { "id": { "type": "string", "title": "Id" }, "source_requirement_id": { "type": "string", "title": "Source Requirement Id" }, "target_requirement_id": { "type": "string", "title": "Target Requirement Id" }, "relationship": { "$ref": "#/components/schemas/XRefRelationship" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "required": [ "id", "source_requirement_id", "target_requirement_id", "relationship" ], "title": "XRef", "description": "Cross-domain dependency record." }, "XRefRelationship": { "type": "string", "enum": [ "DEPENDS_ON", "CONFLICTS_WITH", "SUPPORTS", "REFINES" ], "title": "XRefRelationship" } } }, "servers": [] }