### RISE Orchestrator API Source: https://app.simplenote.com/p/pZ1Tsb/index The RISE orchestrator tool allows for the orchestration of RISE v2 analysis. It supports starting new sessions, running specific analysis phases, retrieving generated artifacts, and suggesting subsequent actions. ```APIDOC ## POST /rise-orchestrator/start_session ### Description Initializes a new RISE session for analyzing a codebase, workflow, or other target. A session ID can be provided externally or generated by the tool. ### Method POST ### Endpoint /rise-orchestrator/start_session ### Parameters #### Request Body - **session_id** (string) - Optional - An external session identifier. If omitted, the tool generates one. - **target_type** (string) - Required - The type of target to analyze. Must be one of: codebase, workflow, product, protocol, storyworld, other. - **target_reference** (string) - Required - A reference to the target. For a codebase, this can be a repo URL or local path. For other types, it's a free-form description or doc path. - **goals** (array[string]) - Optional - High-level outcomes desired from the RISE run. ### Request Example ```json { "target_type": "codebase", "target_reference": "/path/to/local/repo", "goals": ["Generate API documentation", "Identify security vulnerabilities"] } ``` ### Response #### Success Response (200) - **session_id** (string) - The unique identifier for the created session. - **artifact_index** (string) - The path or identifier for the artifact registry of this session. #### Response Example ```json { "session_id": "sess_abc123", "artifact_index": "/artifacts/sess_abc123" } ``` ``` ```APIDOC ## POST /rise-orchestrator/run_phase ### Description Executes a specific RISE phase (R0 through R4) for an existing session. This can be called multiple times, in sequence or selectively, to perform different stages of analysis. ### Method POST ### Endpoint /rise-orchestrator/run_phase ### Parameters #### Request Body - **session_id** (string) - Required - The identifier of the RISE session to run the phase for. - **phase** (string) - Required - The RISE phase to execute. Must be one of: R0, R1, R2, R3, R4. - **scope** (object) - Optional - Narrows the analysis to specific files, components, modules, user journeys, or other subcontexts. - **options** (object) - Optional - Phase-specific configuration options. Examples include `max_question_rounds` for R0, `include_beloved_qualities` for R1, `spec_formats` for R2, `audiences` for R3, and `since_timestamp` or `max_commits` for R4. ### Request Example ```json { "session_id": "sess_abc123", "phase": "R2", "options": { "spec_formats": ["openapi", "markdown"] } } ``` ### Response #### Success Response (200) - **status** (string) - The status of the phase execution. Possible values: started, completed, failed. - **artifacts** (array[object]) - A list of artifacts generated by this phase. Each artifact object contains `id`, `phase`, `kind`, `path`, and `summary`. #### Response Example ```json { "status": "completed", "artifacts": [ { "id": "art_xyz789", "phase": "R2", "kind": "api_spec", "path": "/artifacts/sess_abc123/R2/api_spec.yaml", "summary": "OpenAPI specification for the codebase." } ] } ``` ``` ```APIDOC ## GET /rise-orchestrator/get_artifacts ### Description Retrieves a list of artifacts associated with a specific RISE session. The results can be filtered by phase or artifact kind. ### Method GET ### Endpoint /rise-orchestrator/get_artifacts ### Parameters #### Query Parameters - **session_id** (string) - Required - The identifier of the RISE session. - **phase** (string) - Optional - Filters artifacts by a specific RISE phase (e.g., R0, R1). - **kind** (string) - Optional - Filters artifacts by their kind (e.g., api_spec, code_summary). ### Request Example ``` GET /rise-orchestrator/get_artifacts?session_id=sess_abc123&phase=R2 ``` ### Response #### Success Response (200) - **artifacts** (array[object]) - A list of artifacts matching the criteria. Each artifact object contains `id`, `phase`, `kind`, `path`, and `summary`. #### Response Example ```json { "artifacts": [ { "id": "art_xyz789", "phase": "R2", "kind": "api_spec", "path": "/artifacts/sess_abc123/R2/api_spec.yaml", "summary": "OpenAPI specification for the codebase." }, { "id": "art_pqr456", "phase": "R2", "kind": "markdown_spec", "path": "/artifacts/sess_abc123/R2/markdown_spec.md", "summary": "Markdown documentation for the codebase." } ] } ``` ``` ```APIDOC ## GET /rise-orchestrator/get_artifact_content ### Description Retrieves the full content of a specific artifact from a RISE session. ### Method GET ### Endpoint /rise-orchestrator/get_artifact_content ### Parameters #### Query Parameters - **session_id** (string) - Required - The identifier of the RISE session. - **artifact_id** (string) - Required - The unique identifier of the artifact to retrieve. ### Request Example ``` GET /rise-orchestrator/get_artifact_content?session_id=sess_abc123&artifact_id=art_xyz789 ``` ### Response #### Success Response (200) - **artifact_id** (string) - The identifier of the requested artifact. - **content** (string) - The full content of the artifact. #### Response Example ```json { "artifact_id": "art_xyz789", "content": "openapi: 3.0.0\ninfo:\n title: Sample API\n version: 1.0.0\n..." } ``` ``` ```APIDOC ## POST /rise-orchestrator/suggest_next_action ### Description Proposes the next logical step in the RISE analysis process based on the current artifacts and goals of a session. It can also suggest arguments for a follow-up tool call. ### Method POST ### Endpoint /rise-orchestrator/suggest_next_action ### Parameters #### Request Body - **session_id** (string) - Required - The identifier of the RISE session. - **current_focus** (string) - Optional - A natural-language description of the current area of work for the local agent. ### Request Example ```json { "session_id": "sess_abc123", "current_focus": "Analyzing the main service API endpoints." } ``` ### Response #### Success Response (200) - **recommendation** (string) - A natural-language suggestion for the next action. - **rationale** (string) - The reasoning behind the recommendation. - **suggested_call** (object) - An example of arguments for a subsequent tool call (e.g., `run_phase` or `start_session`). #### Response Example ```json { "recommendation": "Run phase R3 to generate user-facing documentation.", "rationale": "Based on the OpenAPI spec generated in R2 and the goal of creating documentation, R3 is the next logical step.", "suggested_call": { "method": "run_phase", "arguments": { "session_id": "sess_abc123", "phase": "R3", "options": { "audiences": ["developers", "product managers"] } } } } ``` ``` -------------------------------- ### RISE Orchestrator MCP Tool Specification Source: https://app.simplenote.com/p/pZ1Tsb/index This YAML defines the 'rise-orchestrator' tool, which orchestrates RISE v2 analysis. It includes methods for session management, phase execution, artifact retrieval, and action suggestions, specifying inputs and outputs for each. ```yaml name: rise-orchestrator description: > Orchestrates RISE v2 analysis of codebases, workflows, or conceptual systems. Runs structural diagnosis, creative archaeology, spec creation, export, and optional git-log-based evolution. version: 0.1.0 methods: - name: start_session description: Initialize a new RISE session. input: type: object properties: session_id: type: string description: Optional external session identifier. If omitted, tool generates one. target_type: type: string enum: [codebase, workflow, product, protocol, storyworld, other] target_reference: type: string description: > For codebase: repo URL or local path. For workflow/product/etc.: free-form description or doc path. goals: type: array items: type: string description: High-level outcomes the requester wants from this RISE run. required: [target_type, target_reference] output: type: object properties: session_id: type: string artifact_index: type: string description: Path or identifier for the artifact registry for this session. - name: run_phase description: > Run a specific RISE phase (R0–R4) for a given session. Can be called multiple times, in order or selectively, depending on prior work. input: type: object properties: session_id: type: string phase: type: string enum: [R0, R1, R2, R3, R4] scope: type: object description: > Optional narrowing: files, components, modules, user journeys, or other subcontexts to limit analysis. options: type: object description: Phase-specific options, e.g.: R0: max_question_rounds: integer R1: include_beloved_qualities: boolean R2: spec_formats: array[string] R3: audiences: array[string] R4: since_timestamp: string max_commits: integer required: [session_id, phase] output: type: object properties: status: type: string enum: [started, completed, failed] artifacts: type: array items: type: object properties: id: string phase: string kind: string path: string summary: string - name: get_artifacts description: List artifacts for a session, optionally filtered by phase or kind. input: type: object properties: session_id: type: string phase: type: string nullable: true kind: type: string nullable: true required: [session_id] output: type: object properties: artifacts: type: array items: type: object properties: id: string phase: string kind: string path: string summary: string - name: get_artifact_content description: Retrieve the full content of a specific artifact. input: type: object properties: session_id: type: string artifact_id: type: string required: [session_id, artifact_id] output: type: object properties: artifact_id: type: string content: type: string - name: suggest_next_action description: > Given current artifacts and goals, propose the next structurally sensible RISE step. input: type: object properties: session_id: type: string current_focus: type: string description: Optional natural-language description of what the local agent is working on. required: [session_id] output: type: object properties: recommendation: type: string rationale: type: string suggested_call: type: object description: Example arguments for a follow-up run_phase or start_session call. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.