{ "openapi": "3.1.0", "info": { "title": "StrategyForge AI API - infra", "version": "0.1.0" }, "paths": { "/infra/health": { "get": { "tags": [ "infra" ], "summary": "Health", "description": "Liveness/readiness. Returns 200 when the API is up.", "operationId": "health_infra_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } } }, "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": [] }