# ASO-aiOS_EngineFile_Schema_v1.2.0 (Fully Explicit)
# Schema for ASO-aiOS Engine v3.0 Alpha (Function-Driven, autologos-Orchestrated Framework)
# Version 1.2.0: Defines the file structure for the v3.0 Alpha Engine.
# Reflects the function-driven architecture and the use of Internal Autologos for logic.
# All definitions herein are explicit and self-contained for this version.
$schema: "http://json-schema.org/draft-07/schema#"
title: "ASO-aiOS_EngineFile_Schema"
description: "Schema for the ASO-aiOS Engine file structure (v1.2.0 of this schema, for Engine v3.0 Alpha+)."
type: "object"
x-schema-version: "1.2.0" # Using x- prefix for custom schema version property
properties:
file_level_metadata:
description: "The initial YAML frontmatter block (--- delimited) of the Engine file."
type: "object"
properties:
filename: { type: "string", description: "Conceptual base name, e.g., 'ASO-aiOS_Engine'." }
id: { type: "string", description: "Full unique filename for this Engine file instance, WITHOUT extension, e.g., 'ASO-aiOS_Engine_v3.0_Alpha'." }
version: { type: "string", description: "Semantic version of the Engine file instance, e.g., '3.0-Alpha'." }
title: { type: "string", description: "Human-readable descriptive title, e.g., 'ASO-aiOS Engine v3.0 Alpha (Function-Driven Orchestrator using autologos)'." }
path: { type: "string", description: "Intended full save path, WITHOUT extension, e.g., 'aios_core/engine_definitions/ASO-aiOS_Engine_v3.0_Alpha'." }
project_code: { type: "string" }
purpose: { type: "string" }
segment_info: { type: "string", description: "'Complete Alpha Draft' or similar." }
aliases: { type: "array", items: { type: "string" } }
type: { type: "string", const: "Process_Engine_SelfContained_MH_Driven", description: "File type classification. Retained for conceptual continuity." }
conforms_to_schema_version: { type: "string", pattern: "^1\\.2\\.0
quot;, description: "Must conform to this schema version (v1.2.0)." } # Renamed for clarity
required:
- "filename"
- "id"
- "version"
- "title"
- "path"
- "project_code"
- "purpose"
- "segment_info"
- "type"
- "conforms_to_schema_version"
additionalProperties: true
engine_content_metadata_block:
description: "The primary # METADATA YAML comment block, defining the Engine's conceptual properties."
type: "object"
properties:
id: { type: "string", const: "ASO-aiOS_Engine_Core" } # Conceptual ID for this specific ASO application
name: { type: "string", pattern: "^ASO-aiOS Engine v3\\.\\d+.*quot; } # Updated pattern for ASO-aiOS v3.x
version: { type: "string", description: "Engine content version (e.g., '3.0-Alpha'), must match file_level_metadata.version." }
status: { type: "string", enum: ["Active", "Deprecated", "Experimental"] }
description: { type: "string", description: "Describes the Engine's function-driven architecture and use of autologos." }
type: { type: "string", const: "Process_Engine_SelfContained_MH_Driven" }
domain: { type: "string" }
keywords: { type: "array", items: { type: "string" } }
relationships:
type: "object"
properties:
process_group: { type: "string" }
leads_to: { type: "string" }
references_schema: { type: "string", pattern: "^SELF:I\\.A\\.ASO_CCO_Schema_v3\\.\\d+quot; } # Updated for v3.x CCO Schema
uses_internal_utilities_from: { type: "string", pattern: "^SELF:I\\.B\\.ASO_Internal_Utilities_v3\\.\\d+quot;, description: "References minimal internal utilities; primary capabilities are external functions." } # Renamed from uses_skills_from
invokes_meta_process: { type: "string", pattern: "^SELF:I\\.C\\.MRO_Orchestrator_v3\\.\\d+quot; } # Updated for v3.x MRO
uses_knowledge_artifacts: {
type: "array",
items: { type: "string" },
description: "Includes critical reference to external function declarations (e.g., 'function_declarations_v3.0.json') and other KAs."
}
required: ["references_schema", "uses_internal_utilities_from", "invokes_meta_process", "uses_knowledge_artifacts"]
additionalProperties: true
usage:
type: "object"
properties:
instructions_for_ai: { type: "string", description: "High-level instructions emphasizing autologos interpretation and function orchestration." }
required: ["instructions_for_ai"]
required: ["id", "name", "version", "status", "description", "type", "relationships", "usage"]
additionalProperties: true
markdown_structure:
description: "Defines the expected sequence and content model of major Markdown H1 sections."
type: "object"
properties:
h1_section_sequence: { "$ref": "#/definitions/H1SectionSequence" }
section_I_content: { "$ref": "#/definitions/SectionICoreDefinitionsContent_v3" }
section_II_content: { "$ref": "#/definitions/SectionIIOrchestrationKernelContent_v3" }
section_III_content: { "$ref": "#/definitions/SectionIIIMetaHeuristicLibraryContent_v3" } # Renamed for clarity
required: ["h1_section_sequence", "section_I_content", "section_II_content", "section_III_content"]
additionalProperties: false
definitions:
H1SectionSequence:
type: "array"
description: "Ordered list of required H1 section titles."
items:
- { type: "string", const: "# I. CORE EMBEDDED DEFINITIONS" }
- { type: "string", const: "# II. ORCHESTRATION KERNEL" }
- { type: "string", const: "# III. META-HEURISTIC (MH) LIBRARY DEFINITIONS" }
minItems: 3
maxItems: 3
AutologosInstructionBlock: # Defines where Internal Autologos scripts live
description: "A block containing Internal Autologos script. This is the structured representation of procedural logic interpreted by the aiOS."
type: "object"
properties:
autologos_version_used: { type: "string", pattern: "^Alpha v0\\.2quot;, description: "Version of Internal Autologos syntax this script conforms to." }
script_content: { type: "string", description: "The actual Internal Autologos script." }
# Optional description for human readability of the script's purpose
script_description: { type: "string", description: "Optional human-readable description of what this script does." }
required: ["autologos_version_used", "script_content"]
additionalProperties: false
InternalComponentMetadata_v3:
description: "Metadata for components like Meta-Heuristics within their YAML block."
type: "object"
properties:
id: { type: "string" }
name: { type: "string" }
version: { type: "string", pattern: "^3\\.\\d+.*quot; } # Expecting v3.x
status: { type: "string", enum: ["Active", "Deprecated", "Experimental"] }
description: { type: "string", description: "Describes the component's role in the aiOS/ASO application." }
type: { type: "string", const: "MetaHeuristic_Definition" } # Or other component types
domain: { type: "string" }
keywords: { type: "array", items: { type: "string" } }
primary_functions_orchestrated: { type: "array", items: {type: "string"}, description: "Names of key external functions this component typically orchestrates."}
required: ["id", "name", "version", "status", "description", "type", "primary_functions_orchestrated"]
additionalProperties: true
ExplicitYAMLComponent_v3: # For I.A (CCO Schema), I.E (TID Schema)
description: "Structure for a component defined by a Markdown preamble and a YAML code block (Schema definition)."
type: "object"
properties:
markdown_instructions_for_ai: { type: "string" }
yaml_code_block: { type: "object", additionalProperties: true, description: "The actual YAML schema definition." }
required: ["markdown_instructions_for_ai", "yaml_code_block"]
additionalProperties: false
MinimizedInternalUtilitiesComponent_v3: # For I.B
description: "A minimized internal utilities catalog, as most capabilities are external functions."
type: "object"
properties:
markdown_instructions_for_ai: { type: "string", description: "Instructions emphasizing that this is for minimal internal actions." }
# The internal utilities themselves could be defined here in autologos or described.
# Let's define them as a list of AutologosInstructionBlocks for clarity.
internal_utility_definitions: {
type: "array",
items: { "$ref": "#/definitions/AutologosInstructionBlock" },
description: "Definitions of minimal internal utilities written in Internal Autologos."
}
required: ["markdown_instructions_for_ai", "internal_utility_definitions"]
additionalProperties: false
FunctionOrchestratorLogicComponent_v3: # For I.C (MRO), II (Kernel), I.D (Protocols if complex logic)
description: "A component whose core logic is orchestrating external functions, defined in Internal Autologos."
type: "object"
properties:
markdown_instructions_for_ai: { type: "string", description: "Core instructions, emphasizing function orchestration via autologos." }
# The main logic is now explicitly an Autologos script block
orchestration_logic_autologos: { "$ref": "#/definitions/AutologosInstructionBlock" }
# Optional natural language description for human readability
descriptive_logic_summary: { type: "string", description: "Optional human-readable summary of the orchestration logic." }
required: ["markdown_instructions_for_ai", "orchestration_logic_autologos"]
additionalProperties: false
MetaHeuristicDefinition_v3:
description: "Structure for an individual Meta-Heuristic definition (v3.0 function-driven, autologos-orchestrated)."
type: "object",
properties:
markdown_h3_header: { type: "string", pattern: "^### III\\.[A-Z]\\. `[A-Z]{3,}-MH`.*quot; }
markdown_instructions_for_ai_mh_level: { type: "string", description: "Overall instructions for the MH, emphasizing its role in orchestrating external functions using autologos." }
yaml_code_block:
type: "object"
properties:
metadata_comment_block: { "$ref": "#/definitions/InternalComponentMetadata_v3" }
instructions_for_ai_yaml: { type: "string", description: "Specific instructions for AI on orchestrating functions for this MH using autologos." }
trigger: { type: "string", description: "Natural language description of when this MH (and its autologos script) is triggered." }
inputs_description_json_schema: { type: "object", description: "JSON schema describing expected inputs to the MH (often passed as JSON to initial functions)." }
# The core process steps are now an Autologos script
process_steps_autologos: { "$ref": "#/definitions/AutologosInstructionBlock" }
outputs_description_json_schema: { type: "object", description: "JSON schema describing expected outputs from the MH (often aggregated from function results)." }
required: ["metadata_comment_block", "instructions_for_ai_yaml", "trigger", "inputs_description_json_schema", "process_steps_autologos", "outputs_description_json_schema"]
additionalProperties: true
required: ["markdown_h3_header", "markdown_instructions_for_ai_mh_level", "yaml_code_block"]
additionalProperties: false
SectionICoreDefinitionsContent_v3:
description: "Defines the expected sub-components within Section I for v3.0."
type: "object"
properties:
project_state_schema: { "$ref": "#/definitions/ExplicitYAMLComponent_v3" } # Defines ASO_CCO_Schema_v3_0
ai_internal_utilities: { "$ref": "#/definitions/MinimizedInternalUtilitiesComponent_v3" } # Defines ASO_Internal_Utilities_v3_0 (Renamed from ai_skills_catalog)
mro_orchestrator: { "$ref": "#/definitions/FunctionOrchestratorLogicComponent_v3" } # Defines MRO_Orchestrator_v3_0 (Renamed from meta_refine_output)
aso_operational_protocols: { "$ref": "#/definitions/FunctionOrchestratorLogicComponent_v3" } # Defines ASO_OperationalProtocols_v3_0 (Renamed from ai_operational_protocols)
tid_schema: { "$ref": "#/definitions/ExplicitYAMLComponent_v3" } # Defines ASO_TID_Schema_v1_2 (Renamed from tid_schema)
autologos_function_library: { # Optional section for defining reusable Autologos functions
type: "object",
properties:
markdown_instructions_for_ai: {type: "string"},
functions: {
type: "array",
items: { "$ref": "#/definitions/AutologosInstructionBlock"} # Each item is a DEFINE block in Autologos
}
},
required: ["markdown_instructions_for_ai", "functions"]
}
required: ["project_state_schema", "ai_internal_utilities", "mro_orchestrator", "aso_operational_protocols", "tid_schema"]
additionalProperties: false
SectionIIOrchestrationKernelContent_v3:
description: "Defines the content model for Section II (Kernel v3.0)."
allOf:
- { "$ref": "#/definitions/FunctionOrchestratorLogicComponent_v3" }
SectionIIIMetaHeuristicLibraryContent_v3: # Renamed for clarity
description: "Defines the content model for Section III (MH Library v3.0)."
type: "object"
properties:
library_instructions_for_ai: { type: "string", description: "Overall instructions for the MH Library, emphasizing function call orchestration via autologos." }
meta_heuristics_list:
type: "array"
items: { "$ref": "#/definitions/MetaHeuristicDefinition_v3" }
minItems: 1
required: ["library_instructions_for_ai", "meta_heuristics_list"]
additionalProperties: false
required: ["file_level_metadata", "engine_content_metadata_block", "markdown_structure"]
additionalProperties: false