Package ch.so.agi.netl

Class SchemaTools

java.lang.Object

ch.so.agi.netl.SchemaTools

@Component
public class SchemaTools
extends Object

Constructor Summary

Constructors

Constructor	Description
SchemaTools(SchemaService service)

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	create(String theme, String schema)
Map<String,Object>	dropPrevious(String theme, String schema, String planToken)
Map<String,Object>	inspect(String theme, String schema)
Map<String,Object>	list(String theme)
Map<String,Object>	plan(String theme, String schema, String operation, Boolean refreshModels)
Map<String,Object>	recreate(String theme, String schema, String planToken)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SchemaTools

public SchemaTools(SchemaService service)

Method Details

list

@McpTool(name="schema_list",
         description="List configured schemas for a theme without connecting to the database. Use schemas[].ident (edit/pub) as the schema argument of other tools, never schemas[].name.",
         annotations=)
public Map<String,Object> list(@McpToolParam(description="Theme identifier, e.g. demo/standorte",required=true)
 String theme)

plan

@McpTool(name="schema_plan",
         description="Resolve configuration and prerequisites. Default create is read-only. recreate and drop-previous roll back a guarded drop probe and save an operation-specific one-use plan token. BLOCKED means do not execute.",
         annotations=)
public Map<String,Object> plan(@McpToolParam(description="Theme identifier",required=true)
 String theme,
 @McpToolParam(description="Configured ident, e.g. edit or pub. Never the physical schema name or baseName.",required=true)
 String schema,
 @McpToolParam(description="create (default), recreate or drop-previous",required=false)
 String operation,
 @McpToolParam(description="Only for recreate: explicitly resolve external dependencies again. Default false reuses recorded dependencies.",required=false)
 Boolean refreshModels)

inspect

@McpTool(name="schema_inspect",
         description="Inspect the actual local schema. MATCHING means matching a recorded successful run, not independent semantic proof.",
         annotations=)
public Map<String,Object> inspect(@McpToolParam(description="Theme identifier",required=true)
 String theme,
 @McpToolParam(description="Configured ident, e.g. edit or pub. Never the physical schema name or baseName.",required=true)
 String schema)

create

@McpTool(name="schema_create",
         description="Create a missing schema in the dedicated local lab. Call strictly sequentially: await this result before creating another schema. Concurrent calls return BUSY; stop on errors, never automatically retry. Never replaces, deletes or repairs an existing schema. Use only after an explicit creation request.",
         annotations=)
public Map<String,Object> create(@McpToolParam(description="Theme identifier",required=true)
 String theme,
 @McpToolParam(description="Configured ident, e.g. edit or pub. Never the physical schema name or baseName.",required=true)
 String schema)

recreate

@McpTool(name="schema_recreate",
         description="Delete all target schema data and recreate a managed local schema. Requires explicit user rebuild request and a fresh recreate plan token. Never retry automatically.",
         annotations=)
public Map<String,Object> recreate(@McpToolParam(description="Theme identifier",required=true)
 String theme,
 @McpToolParam(description="Configured ident, e.g. edit or pub. Never the physical schema name or baseName.",required=true)
 String schema,
 @McpToolParam(description="One-use token from schema_plan operation recreate",required=true)
 String planToken)

dropPrevious

@McpTool(name="schema_drop_previous",
         description="Delete exactly version n-1 and its managed roles. Requires explicit deletion request and one-use schema_plan operation drop-previous token. No migration or automatic retry.",
         annotations=)
public Map<String,Object> dropPrevious(@McpToolParam(description="Theme identifier",required=true)
 String theme,
 @McpToolParam(description="Configured ident, e.g. edit or pub. Never the physical schema name or baseName.",required=true)
 String schema,
 @McpToolParam(description="One-use drop-previous plan token",required=true)
 String planToken)