@wowok/agent-mcp 2.5.4 → 2.6.0

package/dist/schema/project/index.js

@@ -47,1089 +47,537 @@ export const EdgeKindEnum = z.enum([
     "sub_order",
     "references",
 ]);
-const PuzzleEntrySchema = z
-    .object({
-    puzzle: z
-        .record(z.unknown())
-        .describe("Per-object puzzle snapshot. Shape varies per object_type — see knowledge/<obj>-puzzle.ts."),
-    completeness: z
-        .record(z.unknown())
-        .describe("Completeness assessment from checkPuzzleCompleteness(). Shape varies per object."),
-    missing_dimensions: z
-        .array(z.string())
-        .describe("Dimensions still missing for this object (e.g. ['A','B'])."),
-})
-    .strict();
 export const ProjectOperationInputSchema = z
     .object({
     action: z
         .enum([
         "list_projects",
-        "list_objects",
-        "shareable",
-        "dependencies",
-        "referenced_by",
-        "pre_publish_check",
-        "cross_project_refs",
-        "graph_stats",
-        "save_graph",
-        "load_graph",
-        "analyze_intent",
-        "aggregate_risks",
-        "generate_deployment_doc",
-        "trace_substeps",
-        "get_project_status",
-        "load_project",
-        "fork_project",
-        "export_project",
-        "get_project_files",
-        "validate_stage_unit",
-        "get_stage_assessment",
-        "get_stage_risk_policy",
-        "get_doc_relations",
-        "update_deployment_doc",
-        "validate_validation_chain",
-        "apply_improvement",
-        "get_improvement_queue",
-        "get_flywheel_config",
-        "rollback_stage",
-        "get_reversibility",
+        "create_project",
+        "create_project_from_onchain",
+        "update_project",
+        "get_project_detail",
+        "add_object",
+        "remove_object",
+        "update_object",
+        "create_version",
+        "build_graph",
+        "get_graph",
+        "evaluate_project",
+        "save_evaluation",
+        "compare_projects",
+        "refresh_objects",
+        "get_object_diff",
+        "delete_project",
         "assemble_context",
+        "generate_deployment_doc",
     ])
-        .describe("Action to perform. Six categories:\n" +
-        "1. Graph Query (10): list_projects, list_objects, shareable, dependencies, referenced_by, pre_publish_check, cross_project_refs, graph_stats, save_graph, load_graph.\n" +
-        "2. Project-Based Deployment 5-Stage (4): Call IN ORDER — analyze_intent (Stage 2) → aggregate_risks (Stage 3) → generate_deployment_doc (Stage 4) → trace_substeps (Stage 5). Each action's output includes `next_action` telling you which action to call next. Stage 1 (Project Naming) uses the `project` + `version` params.\n" +
-        "3. Project Memory Layer (5): load_project, fork_project, export_project, get_project_files, get_project_status.\n" +
-        "4. Nested-Autonomy Stage Unit (6): validate_stage_unit, get_stage_assessment, get_stage_risk_policy, get_doc_relations, update_deployment_doc, validate_validation_chain.\n" +
-        "5. Distillation Reflow (3): apply_improvement (review + apply a proposal — config_override writes overrides/, source_patch writes patches/), get_improvement_queue (list pending/approved proposals), get_flywheel_config (query reflow loop status).\n" +
-        "6. Rollback & Reversibility (2): rollback_stage (evaluate + execute stage rollback with file cleanup — blocked if has_published_object), get_reversibility (query object lifecycle reversibility matrix for risk reminders).\n" +
-        "7. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption — bridges raw facts to business-understandable context). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events)."),
+        .describe("Action to perform. Two categories:\n" +
+        "1. Project Entity + Evaluation (15, GLM6): list_projects, create_project, create_project_from_onchain, update_project, get_project_detail, add_object, remove_object, create_version, build_graph, get_graph, evaluate_project, save_evaluation, compare_projects, refresh_objects, get_object_diff. Projects are first-class entities with SQLite persistence, rigid project-object relationships, three-pathway graph construction, and a dual rule-based + LLM-assisted evaluation engine.\n" +
+        "2. Context Assembly (1): assemble_context (query on-chain object states + extract embedded history + optional events, and assemble a structured semantic context for LLM consumption). Required input: context_objects (array of object IDs/names). Optional: include_events (query recent state-transition events)."),
     project: z
         .string()
         .optional()
-        .describe("Project prefix (for list_objects and C1-C4 actions)"),
+        .describe("Project prefix (human-readable unique identifier). Used by create_version, build_graph, evaluate_project, etc. Takes precedence resolution: project_id > project (prefix)."),
     version: z
         .string()
         .regex(/^v\d+$/)
         .optional()
-        .describe("Project version (e.g. 'v1'). Required for C1-C4 actions."),
-    object: z
-        .string()
+        .describe("Project version (e.g. 'v1'). Used by create_version."),
+    context_objects: z
+        .array(z.string())
         .optional()
-        .describe("Object name or address (for dependencies / referenced_by / pre_publish_check)"),
-    fork_to_version: z
-        .string()
-        .regex(/^v\d+$/)
+        .describe("Object IDs (0x...) or LocalMark names to assemble context for. Required when action='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations."),
+    include_events: z
+        .boolean()
         .optional()
-        .describe("Target version for fork_project (e.g. 'v2'). Must differ from source 'version'."),
-    fork_to_prefix: z
-        .string()
+        .describe("When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed."),
+    context_network: z
+        .enum(["testnet", "mainnet"])
+        .optional()
+        .describe("Network for assemble_context queries. Defaults to 'testnet' if omitted."),
+    filter_status: z
+        .enum(["draft", "active", "inactive", "archived"])
+        .optional()
+        .describe("Filter list_projects by project status."),
+    filter_perspective: z
+        .enum(["producer", "consumer", "both"])
         .optional()
-        .describe("Target prefix for fork_project. Defaults to source 'project' prefix when omitted."),
-    user_intent: z
+        .describe("Filter list_projects by project perspective."),
+    filter_network: z
+        .enum(["testnet", "mainnet"])
+        .optional()
+        .describe("Filter list_projects by network."),
+    project_name: z
         .string()
         .min(1)
+        .max(200)
+        .optional()
+        .describe("Display name for create_project / create_project_from_onchain / update_project. Required when action='create_project'."),
+    project_description: z
+        .string()
         .max(2000)
         .optional()
-        .describe("Natural-language business intent for analyze_intent (stage 2). Required when action='analyze_intent'."),
-    industry: IndustryEnum.optional().describe("Industry hint — drives template defaults. Used by analyze_intent and aggregate_risks."),
-    target_objects: z
+        .describe("Project description for create_project / update_project."),
+    project_industry: IndustryEnum.optional().describe("Industry tag for create_project. Drives template defaults."),
+    project_perspective: z
+        .enum(["producer", "consumer", "both"])
+        .optional()
+        .describe("Project perspective for create_project. 'producer' = build/operate services, 'consumer' = evaluate/buy services, 'both' = dual role. Defaults to 'producer'."),
+    project_labels: z
         .array(z.string())
         .optional()
-        .describe("Optional explicit target objects (entry_ids or object_type names) for analyze_intent."),
-    puzzles: z
-        .record(z.string(), PuzzleEntrySchema)
+        .describe("Free-form labels for create_project / update_project (e.g. ['travel','london','priority'])."),
+    service_address: z
+        .string()
         .optional()
-        .describe("Per-object puzzle snapshots keyed by object_type. Required for aggregate_risks and generate_deployment_doc."),
-    severity_threshold: z
-        .enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"])
+        .describe("On-chain Service object address. Required for create_project_from_onchain. Optional for create_project (links the project to its core Service)."),
+    project_network: z
+        .enum(["testnet", "mainnet"])
         .optional()
-        .describe("Severity threshold for aggregate_risks. Risks at or above this level are flagged."),
-    user_confirmed_high_risks: z
-        .array(z.string())
+        .describe("Network the project is bound to. A Service deployed to different networks are different projects. Defaults to 'testnet'."),
+    project_id: z
+        .string()
+        .optional()
+        .describe("Project UUID for update_project / get_project_detail / add_object / remove_object / create_version / build_graph / evaluate_project / refresh_objects. Takes precedence over 'project' (prefix) when both are given."),
+    project_status: z
+        .enum(["draft", "active", "inactive", "archived"])
         .optional()
-        .describe("IDs of HIGH risks the user has already confirmed (suppressed in subsequent aggregate_risks)."),
-    business_intent: z
+        .describe("New status for update_project. 'active' projects are live, 'archived' are read-only."),
+    object_address: z
         .string()
-        .min(1)
-        .max(500)
         .optional()
-        .describe("One-line business intent description for the deployment doc. Required when action='generate_deployment_doc'."),
-    author: z
+        .describe("On-chain object address (0x...) for add_object / remove_object. For add_object, alternatively use object_name to resolve via LocalMark."),
+    object_name_add: z
         .string()
         .optional()
-        .describe("Optional author name for the deployment doc meta section."),
-    objects: z
-        .array(z
-        .object({
-        entry_id: z.string().describe("Stable id '<object_type>:<name>'"),
-        object_type: ProjectObjectTypeEnum,
-        name: z.string(),
-        reused_from: z
-            .string()
-            .optional()
-            .describe("Existing on-chain address or local name if reused"),
-        publish_required: z
-            .boolean()
-            .describe("Whether publish is required (only Service/Machine)"),
-        description: z.string().optional(),
-    })
-        .strict())
+        .describe("LocalMark name for add_object (alternative to object_address)."),
+    object_type_add: z
+        .enum([
+        "Service", "Machine", "Guard", "Permission", "Reward", "Arbitration",
+        "Progress", "Treasury", "Demand", "Repository", "Contact", "Order",
+        "Allocation", "Personal", "Payment", "Proof",
+    ])
         .optional()
-        .describe("Deployment objects for generate_deployment_doc."),
-    edges: z
-        .array(z
-        .object({
-        from: z.string(),
-        to: z.string(),
-        edge_kind: EdgeKindEnum,
-        field_path: z.string(),
-        required_at_publish: z.boolean(),
-    })
-        .strict())
+        .describe("Object type for add_object."),
+    object_role: z
+        .enum(["core", "dependency", "reference"])
         .optional()
-        .describe("Dependency graph edges for generate_deployment_doc."),
-    steps: z
-        .array(z
-        .object({
-        step: z.number().int().positive(),
-        object_type: ProjectObjectTypeEnum,
-        operation: z.string(),
-        substep_count: z.number().int().nonnegative(),
-        depends_on: z.array(z.number().int()),
-        entry_id: z.string(),
-        network_phase: z.enum(["testnet", "mainnet", "both"]),
-    })
-        .strict())
+        .describe("Object role in project for add_object. 'core' = the Service (only one per project), 'dependency' = required binding, 'reference' = optional/auxiliary. Defaults to 'reference'."),
+    object_tags_add: z
+        .array(z.string())
         .optional()
-        .describe("Topological execution plan for generate_deployment_doc."),
-    scenarios: z
-        .array(z
-        .object({
-        scenario_id: z.string(),
-        description: z.string(),
-        primary_object: z.string(),
-        supporting_objects: z.array(z.string()),
-        test_step_refs: z.array(z.string()).optional(),
-    })
-        .strict())
+        .describe("Tags for add_object."),
+    object_id_remove: z
+        .string()
         .optional()
-        .describe("Business scenarios for generate_deployment_doc §7."),
-    risk_status: z
-        .enum(["RISK_PASSED", "RISK_BLOCKED", "RISK_PENDING_CONFIRM", "RISK_CANCELLED"])
+        .describe("ProjectObject UUID for remove_object (the project_objects.id, NOT the on-chain address)."),
+    object_id_update: z
+        .string()
         .optional()
-        .describe("Risk status from aggregate_risks (for D-16 check)."),
-    risk_critical_count: z
-        .number()
-        .int()
-        .nonnegative()
+        .describe("ProjectObject UUID for update_object (the project_objects.id)."),
+    object_name_update: z
+        .string()
         .optional()
-        .describe("CRITICAL risk count from aggregate_risks."),
-    risk_high_count: z
-        .number()
-        .int()
-        .nonnegative()
+        .describe("New name for update_object."),
+    object_type_update: z
+        .string()
         .optional()
-        .describe("HIGH risk count from aggregate_risks."),
-    run_scanner: z
-        .boolean()
+        .describe("New type for update_object."),
+    object_role_update: z
+        .enum(["core", "dependency", "reference"])
         .optional()
-        .describe("Whether to run deployment-scanner validation after generating the doc. Defaults to true."),
-    gas_budget: z
-        .object({
-        network: z.enum(["testnet", "mainnet"]),
-        already_spent_gas: z
-            .number()
-            .int()
-            .nonnegative()
-            .optional()
-            .describe("Gas already spent on-chain in MIST (from telemetry). Defaults to 0."),
-        estimated_rerun_gas: z
-            .number()
-            .int()
-            .nonnegative()
-            .optional()
-            .describe("Estimated gas to re-run remaining ops in MIST. Auto-computed from estimateDeploymentGas when omitted."),
-        warning: z
-            .string()
-            .optional()
-            .describe("Custom warning text. Defaults to a computed cost summary."),
-    })
+        .describe("New role for update_object."),
+    object_tags_update: z
+        .array(z.string())
         .optional()
-        .describe("Gas budget input for stage 4/5 gate (§3.5). Non-blocking; only surfaces a WARN on mainnet."),
-    network: z
-        .enum(["testnet", "mainnet"])
+        .describe("New tags for update_object."),
+    version_description: z
+        .string()
+        .max(500)
         .optional()
-        .describe("Target network for trace_substeps."),
-    substeps: z
-        .array(z
-        .object({
-        step_id: z.string().regex(/^T\d+\.\d+$/),
-        parent_step: z.string().regex(/^T\d+$/),
-        object_type: ProjectObjectTypeEnum,
-        entry_id: z.string(),
-        operation_type: z.string(),
-        network: z.enum(["testnet", "mainnet"]),
-        input: z.object({
-            data: z.record(z.unknown()),
-            input_refs: z.array(z.string()),
-        }),
-        output: z
-            .object({
-            object_id: z.string().optional(),
-            tx_digest: z.string().optional(),
-        })
-            .partial()
-            .optional(),
-        timestamp: z.number().int(),
-        status: z.enum(["PENDING", "SUCCESS", "FAILED", "SKIPPED"]),
-        failure_reason: z.string().optional(),
-        dependencies: z.object({
-            input_refs: z.array(z.string()),
-            output_refs: z.array(z.object({
-                substep_id: z.string(),
-                field_path: z.string(),
-            })),
-        }),
-        retry_info: z
-            .object({
-            original_step_id: z.string(),
-            retry_count: z.number().int().nonnegative(),
-            retry_reason: z.string(),
-        })
-            .optional(),
-    })
-        .strict())
+        .describe("Description for create_version."),
+    fork_from_version: z
+        .string()
         .optional()
-        .describe("Substep records for trace_substeps."),
-    target_stage: z
+        .describe("Source version for create_version (fork objects + graph from this version)."),
+    max_depth: z
         .number()
         .int()
         .min(1)
         .max(5)
         .optional()
-        .describe("Stage number (1-5) for validate_stage_unit, get_stage_assessment, get_stage_risk_policy, and rollback_stage (the stage to rollback to). Required by these 4 actions."),
-    proposal_id: z
-        .string()
-        .optional()
-        .describe("Improvement proposal ID (for apply_improvement). Required by apply_improvement."),
-    review_status: z
-        .enum(["approved", "rejected", "applied"])
-        .optional()
-        .describe("New review status to set (for apply_improvement). 'approved' triggers application (config_override or source_patch); 'rejected' marks as rejected; 'applied' marks as already applied."),
-    queue_filter_status: z
-        .enum(["pending", "approved", "rejected", "applied"])
+        .describe("Max recursion depth for Pathway 1 (internal reference derivation) in build_graph. Default 3."),
+    enable_registrar: z
+        .boolean()
         .optional()
-        .describe("Filter the improvement queue by review_status (for get_improvement_queue)."),
-    queue_filter_type: z
-        .string()
+        .describe("Enable Pathway 2 (Registrar inbound query) in build_graph. Default true."),
+    enable_potential: z
+        .boolean()
         .optional()
-        .describe("Filter the improvement queue by proposal type (for get_improvement_queue)."),
-    queue_filter_priority: z
-        .string()
+        .describe("Enable Pathway 3 (potential relationship detection) in build_graph. Default false."),
+    evaluation_type: z
+        .enum(["risk", "trust", "completeness", "value", "worth_buying"])
         .optional()
-        .describe("Filter the improvement queue by priority P0/P1/P2/P3 (for get_improvement_queue)."),
-    dry_run: z
+        .describe("Evaluation type for evaluate_project. risk/trust/completeness are rule-based (computed locally). worth_buying/value require LLM assistance (returns a prompt for the caller to process)."),
+    refresh_before_eval: z
         .boolean()
         .optional()
-        .describe("When true, rollback_stage only evaluates the policy and returns the cleanup plan WITHOUT executing the rollback. Defaults to false (execute)."),
-    query_object_type: z
+        .describe("When true, evaluate_project refreshes object cache from chain before evaluating. Default false."),
+    eval_score: z
+        .number()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe("Overall evaluation score (0-100) for save_evaluation."),
+    eval_summary: z
         .string()
+        .max(1000)
         .optional()
-        .describe("Object type for get_reversibility query (e.g. 'service', 'machine', 'guard'). When omitted, returns the full matrix."),
-    query_lifecycle_state: z
-        .enum(["created", "referenced", "published", "bound"])
+        .describe("Evaluation summary for save_evaluation."),
+    eval_details: z
+        .record(z.unknown())
         .optional()
-        .describe("Object lifecycle state for get_reversibility query. When omitted, returns all lifecycle states for the given object_type."),
-    context_objects: z
+        .describe("Structured evaluation details for save_evaluation (criterion_scores, findings, etc.)."),
+    compare_project_ids: z
         .array(z.string())
+        .min(2)
         .optional()
-        .describe("Object IDs (0x...) or LocalMark names to assemble context for. Required when action='assemble_context'. The current on-chain state of each object will be queried and enriched with semantic annotations."),
-    include_events: z
-        .boolean()
+        .describe("Array of project IDs to compare (for compare_projects). Minimum 2."),
+    diff_address: z
+        .string()
         .optional()
-        .describe("When true, assemble_context also queries recent state-transition events (NewOrderEvent, ProgressEvent, ArbEvent, etc.). Events are the real-time transition log — convergent and bounded. Defaults to false. Note: object-embedded history (ProgressSession.forwards, Order.disputes) is ALWAYS extracted automatically — no flag needed."),
-    context_network: z
-        .enum(["testnet", "mainnet"])
+        .describe("Object address for get_object_diff."),
+    diff_from_time: z
+        .number()
+        .int()
         .optional()
-        .describe("Network for assemble_context queries. Defaults to 'testnet' if omitted."),
-})
-    .strict();
-const GateValidationSchema = z
-    .object({
-    stage: z.number().int().min(1).max(5),
-    passed: z.boolean().describe("True when no FAIL checks exist."),
-    checks: z.array(z.object({
-        dimension: z.enum([
-            "semantic",
-            "tools",
-            "reversibility",
-            "risk",
-            "isolation",
-            "gas_budget",
-        ]),
-        status: z.enum(["PASS", "FAIL", "WARN"]),
-        message: z.string(),
-    })),
-    blocking_issues: z.array(z.string()),
-    warnings: z.array(z.string()),
-    can_proceed: z.boolean(),
-})
-    .optional()
-    .describe("Stage gate validation result (6 dimensions: semantic/tools/reversibility/risk/isolation/gas_budget).");
-const ItemsResult = (action) => z.object({
-    action: z.literal(action),
-    items: z
-        .array(z.record(z.unknown()))
-        .describe("List of result items. Each item is an untyped record — shape varies per query."),
-});
-const AnalyzeIntentResultSchema = z
-    .object({
-    action: z.literal("analyze_intent"),
-    intent_parsed: z.object({
-        primary_object: z.string(),
-        secondary_objects: z.array(z.string()),
-        detected_scenes: z.array(z.object({
-            object: z.string(),
-            scene_id: z.string(),
-        })),
-        industry: z.string(),
-        keyword_matches: z.array(z.object({
-            keyword: z.string(),
-            category: z.string(),
-            matched_objects: z.array(z.string()),
-            required_level: z.enum(["R", "C", "OPTIONAL"]),
-            match_count: z.number().int(),
-        })),
-    }),
-    puzzles: z.record(z.string(), PuzzleEntrySchema),
-    overall_completeness: z.enum(["complete", "partial", "empty"]),
-    next_step: z.string(),
-    recommended_creation_order: z
-        .array(z.string())
-        .describe("Recommended object creation order based on dependency topology (e.g. ['permission','progress','guard','allocation','machine','service'])."),
-    next_action: z
-        .enum(["aggregate_risks", "none"])
-        .describe("Next project_operation action to call. 'aggregate_risks' when puzzles are complete enough; 'none' if user must fill missing fields first."),
-    warnings: z.array(z.string()),
-    gate_validation: GateValidationSchema,
-})
-    .strict();
-const AggregateRisksResultSchema = z
-    .object({
-    action: z.literal("aggregate_risks"),
-    namespace: z.object({
-        prefix: z.string(),
-        version: z.string(),
-        industry: z.string().optional(),
-    }),
-    findings: z.array(z.object({
-        risk_rule_id: z.string(),
-        object_type: z.string(),
-        entry_id: z.string(),
-        severity: z.enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"]),
-        message: z.string(),
-        fix_suggestion: z.string(),
-        details: z
-            .object({
-            field_path: z.string().optional(),
-            rule_source: z.string().optional(),
-        })
-            .partial()
-            .optional(),
-    })),
-    severity_summary: z.object({
-        CRITICAL: z.number().int(),
-        HIGH: z.number().int(),
-        MEDIUM: z.number().int(),
-        LOW: z.number().int(),
-        INFO: z.number().int(),
-    }),
-    status: z.enum([
-        "RISK_PASSED",
-        "RISK_BLOCKED",
-        "RISK_PENDING_CONFIRM",
-        "RISK_CANCELLED",
-    ]),
-    pending_confirmations: z
-        .array(z.object({
-        risk_rule_id: z.string(),
-        description: z.string(),
-        fix_suggestion: z.string(),
-        object_type: z.string(),
-        entry_id: z.string(),
-    }))
-        .optional(),
-    fix_suggestions_grouped: z
-        .record(z.string(), z.array(z.object({
-        risk_rule_id: z.string(),
-        severity: z.enum(["CRITICAL", "HIGH", "MEDIUM", "LOW", "INFO"]),
-        message: z.string(),
-        fix_suggestion: z.string(),
-        entry_id: z.string(),
-    })))
+        .describe("Start timestamp (ms) for get_object_diff."),
+    diff_to_time: z
+        .number()
+        .int()
         .optional()
-        .describe("Fix suggestions grouped by object_type for better readability."),
-    calibrated_at: z.number().int(),
-    warnings: z.array(z.string()),
-    can_proceed: z
+        .describe("End timestamp (ms) for get_object_diff."),
+    network: z
+        .enum(["testnet", "mainnet"])
+        .optional()
+        .describe("Target network for generate_deployment_doc. Required when action='generate_deployment_doc'."),
+    save: z
         .boolean()
-        .describe("Whether the user can proceed to the next stage. False only when CRITICAL risks exist."),
-    next_action: z
-        .enum(["generate_deployment_doc", "fix_risks", "none"])
-        .describe("Next project_operation action. 'generate_deployment_doc' when can_proceed=true; 'fix_risks' when CRITICAL risks exist; 'none' for other cases."),
-    user_action_required: z
-        .string()
-        .describe("Human-readable next-step guidance."),
-    gate_validation: GateValidationSchema,
+        .optional()
+        .describe("When true (default), persist the generated MD to SQLite project_documents table for generate_deployment_doc."),
 })
     .strict();
-const GenerateDeploymentDocResultSchema = z
+const AssembleContextResultSchema = z
     .object({
-    action: z.literal("generate_deployment_doc"),
-    markdown: z.string().describe("Complete deployment MD document (§0-§7)"),
-    meta: z.object({
-        project_prefix: z.string(),
-        version: z.string(),
-        generated_at: z.string().describe("ISO timestamp"),
-        object_count: z.number().int(),
-        step_count: z.number().int(),
-    }),
-    validation: z
-        .object({
-        valid: z.boolean(),
-        checks: z.array(z.object({
-            check_id: z.string(),
-            description: z.string(),
-            status: z.enum(["PASS", "FAIL", "WARN"]),
-            notes: z.string().optional(),
-        })),
-        errors: z.array(z.string()),
-    })
+    action: z.literal("assemble_context"),
+    objects: z
+        .array(z.unknown())
+        .describe("Current on-chain states of the requested objects (from query_objects)."),
+    events: z
+        .array(z.unknown())
         .optional()
-        .describe("Scanner validation result. Present when run_scanner=true."),
-    estimated_gas: z
-        .object({
-        total_gas_mist: z.number().int().describe("Estimated total gas in MIST (1 WOW = 10^9 MIST)."),
-        per_object: z.array(z.object({
-            entry_id: z.string(),
-            object_type: z.string(),
-            create_gas_mist: z.number().int(),
-            publish_gas_mist: z.number().int(),
-        })),
-        publish_gas_mist: z.number().int().describe("Gas for publish operations only."),
-    })
+        .describe("Recent state-transition events (only when include_events=true). " +
+        "Includes NewOrderEvent, ProgressEvent, ArbEvent, etc."),
+    embedded_history: z
+        .record(z.string(), z.unknown())
         .optional()
-        .describe("Gas cost estimate for deploying all objects."),
-    persisted: z
+        .describe("Operation history extracted from object states — NOT from tx queries. " +
+        "Progress objects: session.forwards (who did what, when, accomplished). " +
+        "Order objects: disputes, claimed_by, progress_object. " +
+        "This is the CORRECT history source: convergent, no infinite recursion."),
+    semantic_summary: z
+        .unknown()
+        .optional()
+        .describe("Business semantic annotations generated by buildDataSemantic — " +
+        "maps raw object fields to business-meaningful concepts for LLM consumption."),
+    context_digest: z
+        .string()
+        .describe("Unique digest for this assembled context (SHA of object IDs + versions + timestamp). " +
+        "Use for caching or to detect state changes between two assembly calls."),
+    next_action: z
+        .string()
+        .describe("Suggested next action: use onchain_transaction to verify a specific past tx, " +
+        "or proceed with onchain_operations to modify state, or re-call assemble_context " +
+        "after state changes."),
+    flywheel_collected: z
         .object({
-        all_files: z
-            .array(z.string())
-            .describe("Project-relative paths of all generated files (27 total)."),
-        all_stages_passed: z
-            .boolean()
-            .describe("Whether all 5 stage gates passed validation."),
+        signature_recorded: z.boolean().describe("Whether the experience signature was recorded in the real-time experience layer."),
+        proposal_created: z.boolean().describe("Whether an improvement proposal was created for the offline distillation flywheel."),
+        proposal_id: z.string().optional().describe("The proposal ID, if created."),
     })
         .optional()
-        .describe("Nested-autonomy doc set persistence result (§11). Present when the doc set was successfully written to disk."),
-    can_proceed: z
-        .boolean()
-        .describe("Whether the user can proceed to stage 5. False when D-errors exist."),
-    next_action: z
-        .enum(["trace_substeps", "fix_doc_errors", "none"])
-        .describe("Next project_operation action. 'trace_substeps' when can_proceed=true; 'fix_doc_errors' when D-errors exist; 'none' for other cases."),
-    user_action_required: z.string(),
-    gate_validation: GateValidationSchema,
+        .describe("Distillation flywheel collection result. Non-blocking — may be undefined if collection fails. " +
+        "When present, the assembled context has been fed back into the experience layer and/or improvement queue."),
 })
     .strict();
-const TraceSubstepsResultSchema = z
+const ProjectObjectSchema = z
     .object({
-    action: z.literal("trace_substeps"),
-    namespace: z.object({
-        prefix: z.string(),
-        version: z.string(),
-    }),
-    network: z.enum(["testnet", "mainnet"]),
-    coherent: z
-        .boolean()
-        .describe("True when no dangling/circular/missing/cross-step issues."),
-    dangling_inputs: z.array(z.object({
-        substep_id: z.string(),
-        missing_ref: z.string(),
-        field_path: z.string(),
-    })),
-    circular_refs: z.array(z.object({
-        cycle: z.array(z.string()),
-    })),
-    missing_outputs: z.array(z.object({
-        substep_id: z.string(),
-        expected_field: z.string(),
-        dependent_substeps: z.array(z.string()),
-    })),
-    cross_step_breaks: z.array(z.object({
-        source_step: z.string(),
-        target_step: z.string(),
-        missing_field: z.string(),
-    })),
-    step_details: z.array(z.object({
-        parent_step: z.string(),
-        total_substeps: z.number().int(),
-        successful: z.number().int(),
-        failed: z.number().int(),
-        pending: z.number().int(),
-        skipped: z.number().int(),
-        substep_ids: z.array(z.string()),
-    })),
-    topological_order: z.array(z.string()),
-    d10_check: z.object({
-        check_id: z.literal("D-10"),
-        description: z.string(),
-        status: z.enum(["PASS", "FAIL", "WARN"]),
-    }),
-    can_proceed: z
-        .boolean()
-        .describe("Whether deployment can complete. False when D-10 fails or substeps FAILED."),
-    next_action: z
-        .enum(["deploy", "fix_substeps", "none"])
-        .describe("Next action. 'deploy' when can_proceed=true (execute substeps via onchain_operations); 'fix_substeps' when issues exist; 'none' when done."),
-    user_action_required: z.string(),
-    gate_validation: GateValidationSchema,
+    id: z.string().describe("ProjectObject UUID (project_objects.id)."),
+    projectId: z.string().describe("Owning project UUID."),
+    objectAddress: z.string().describe("On-chain object address (0x...)."),
+    objectType: z.string().nullable().describe("Object type (Service, Machine, etc.) or null if unknown."),
+    objectName: z.string().nullable().describe("LocalMark name or null."),
+    role: z.enum(["core", "dependency", "reference"]).describe("Object role in project."),
+    tags: z.array(z.string()).nullable().describe("Tags array or null."),
+    addedAt: z.number().describe("Timestamp (ms) when added to project."),
+    metadata: z.record(z.unknown()).nullable().describe("Arbitrary metadata key-value pairs or null."),
 })
     .strict();
-const GetProjectStatusResultSchema = z
+const ProjectSchema = z
     .object({
-    action: z.literal("get_project_status"),
-    project: z.string(),
-    version: z.string(),
-    stage: z.number().int().min(1).max(5),
-    stage_name: z.string(),
-    stage_description: z.string(),
-    next_action: z.string().describe("The next project_operation action to call."),
-    can_proceed: z.boolean(),
-    last_updated: z.number().int().optional().describe("Timestamp of last stage update (ms)."),
-    risk_status: z.string().optional(),
-    risk_can_proceed: z.boolean().optional(),
-    doc_generated: z.boolean().optional(),
-    trace_coherent: z.boolean().optional(),
+    id: z.string().describe("Project UUID."),
+    prefix: z.string().describe("Human-readable unique prefix."),
+    name: z.string().describe("Display name."),
+    description: z.string().nullable(),
+    industry: z.string().nullable(),
+    perspective: z.enum(["producer", "consumer", "both"]),
+    status: z.enum(["draft", "active", "inactive", "archived"]),
+    labels: z.array(z.string()).nullable(),
+    currentVersion: z.string().nullable().describe("Current version tag (e.g. 'v1')."),
+    serviceAddress: z.string().nullable().describe("Core Service on-chain address (producer projects)."),
+    defaultAccount: z.string().nullable(),
+    network: z.string().describe("Network the project is bound to."),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    metadata: z.record(z.unknown()).nullable().describe("Arbitrary metadata key-value pairs or null."),
 })
     .strict();
-const LoadProjectListItemSchema = z.object({
-    prefix: z.string(),
-    version: z.string(),
-    dir_name: z.string(),
-    initialized: z.boolean(),
-    archived: z.boolean(),
-    needs_migration: z.boolean().describe("Whether schema_version differs from current."),
-    forked_from: z.string().optional(),
-    chain_exists: z.boolean().describe("Whether the project prefix exists on-chain."),
-    sync_status: z
-        .enum(["synced", "local_only", "archived", "uninitialized"])
-        .describe("Cross-validation of local filesystem vs chain truth."),
+const ProjectListItemSchema = ProjectSchema.extend({
+    objectCount: z.number().describe("Number of objects in this project (from project_objects table)."),
+    evaluationCount: z.number().describe("Number of stored evaluations for this project (from evaluations table)."),
+    objectTypes: z.array(z.string()).describe("Distinct object types in this project (e.g. ['Service','Machine'])."),
 });
-const LoadProjectResultSchema = z
+const ListProjectsResultSchema = z
     .object({
-    action: z.literal("load_project"),
-    items: z.array(LoadProjectListItemSchema).optional(),
-    total: z.number().int().optional(),
-    project: z.string().optional(),
-    version: z.string().optional(),
-    local_exists: z.boolean().optional(),
-    manifest: z
-        .object({
-        schema_version: z.string(),
-        mcp_version: z.string(),
-        prefix: z.string(),
-        version: z.string(),
-        created_at: z.string(),
-        updated_at: z.string(),
-        forked_from: z.string().optional(),
-        needs_recalibration: z.boolean().optional(),
-    })
-        .optional(),
-    stage_state: z
-        .object({
-        stage: z.number().int().min(1).max(5),
-        updated_at: z.number().int(),
-        has_published_object: z.boolean(),
-        archived: z.boolean(),
-    })
-        .partial()
-        .optional(),
-    sync_status: z
-        .object({
-        local_exists: z.boolean(),
-        initialized: z.boolean(),
-        needs_migration: z.boolean(),
-        archived: z.boolean(),
-    })
-        .optional(),
-    migration: z
-        .object({
-        migrated: z.boolean().describe("Whether a migration was performed."),
-        from_version: z.string(),
-        to_version: z.string(),
-        steps_executed: z.array(z.string()),
-        backup_path: z.string().optional(),
-        needs_recalibration: z.boolean(),
-        message: z.string(),
-    })
-        .optional(),
-    message: z.string().optional(),
+    action: z.literal("list_projects"),
+    items: z.array(ProjectListItemSchema).describe("GLM6 projects from SQLite (first-class entities, with object summary)."),
+    total: z.number().describe("Total number of projects returned."),
 })
     .strict();
-const ForkProjectResultSchema = z
-    .object({
-    action: z.literal("fork_project"),
-    new_prefix: z.string(),
-    new_version: z.string(),
-    new_path: z.string().describe("Absolute filesystem path of the new project directory."),
-    forked_from: z
-        .string()
-        .describe("Absolute path of the source project directory."),
-    copied_files: z
-        .array(z.string())
-        .describe("Project-relative paths of copied files (excludes stage.json + audit.jsonl)."),
-    copied_file_count: z.number().int(),
-    warning: z
-        .string()
-        .describe("Project isolation notice — forked project must re-create its own objects."),
-    next_action: z
-        .literal("analyze_intent")
-        .describe("The forked project starts at stage 2 (analyze_intent)."),
-})
+const CreateProjectResultSchema = z
+    .object({ action: z.literal("create_project"), project: ProjectSchema.describe("The created project.") })
     .strict();
-const ExportProjectResultSchema = z
+const CreateProjectFromOnchainResultSchema = z
     .object({
-    action: z.literal("export_project"),
-    project: z.string(),
-    version: z.string(),
-    files: z.array(z.object({
-        path: z.string().describe("Project-relative file path."),
-        size: z.number().int().describe("File size in bytes."),
-        kind: z.enum(["json", "markdown", "jsonl", "other"]),
-        content: z.string().describe("File content (text)."),
-    })),
-    total_files: z.number().int(),
+    action: z.literal("create_project_from_onchain"),
+    project: ProjectSchema.describe("The created consumer project."),
+    objects: z.array(ProjectObjectSchema).describe("Objects discovered from on-chain Service + graph traversal."),
+    graphEdgeCount: z.number().describe("Number of relationship edges discovered and persisted."),
 })
     .strict();
-const GetProjectFilesResultSchema = z
+const UpdateProjectResultSchema = z
+    .object({ action: z.literal("update_project"), project: ProjectSchema.describe("The updated project.") })
+    .strict();
+const EvaluationDetailsSchema = z
     .object({
-    action: z.literal("get_project_files"),
-    project: z.string(),
-    version: z.string(),
-    files: z.array(z.object({
-        path: z.string().describe("Project-relative file path."),
-        size: z.number().int().describe("File size in bytes."),
-        kind: z.enum(["json", "markdown", "jsonl", "other"]),
-        mtime: z.number().int().describe("Last modified time (ms)."),
-    })),
-    total_files: z.number().int(),
+    criterionScores: z
+        .array(z.object({
+        name: z.string().describe("Criterion name (e.g. 'Service Published', 'Governance Present')."),
+        score: z.number().describe("Per-criterion score (0-100, higher = better)."),
+        weight: z.number().describe("Weight in the overall score (0-1)."),
+        rationale: z.string().describe("Why this score was assigned."),
+    }).strict())
+        .describe("Per-criterion scores with rationale."),
+    findings: z
+        .array(z.object({
+        criterion: z.string().describe("Criterion this finding relates to."),
+        severity: z.enum(["critical", "warning", "info"]).describe("Severity level: critical (blocks deployment), warning (should fix), info (advisory)."),
+        message: z.string().describe("Human-readable finding description."),
+        deduction: z.number().describe("Score deduction applied (negative number, e.g. -20)."),
+    }).strict())
+        .describe("Negative findings (warnings/critical issues) with deductions."),
+    strengths: z
+        .array(z.string())
+        .describe("Positive evidence explaining high scores."),
 })
     .strict();
-const ValidateStageUnitResultSchema = z
+const GetProjectDetailResultSchema = z
     .object({
-    action: z.literal("validate_stage_unit"),
-    project: z.string(),
-    version: z.string(),
-    stage: z.number().int().min(1).max(5),
-    valid: z
-        .boolean()
-        .describe("True when all 4 stage unit files exist and pass consistency checks."),
-    missing_files: z
-        .array(z.string())
-        .describe("Project-relative paths of missing stage unit files (empty if all present)."),
-    checks: z.array(z.object({
-        check_id: z.string(),
-        status: z.enum(["pass", "fail", "warn"]),
-        message: z.string(),
-    })),
-    blocking_issues: z.array(z.string()),
-    stage_passed: z
-        .boolean()
-        .optional()
-        .describe("From verification.json stage_passed field (undefined if file missing)."),
+    action: z.literal("get_project_detail"),
+    project: ProjectSchema,
+    objects: z.array(ProjectObjectSchema).describe("Project objects (rigid relationships)."),
+    graphEdgeCount: z.number().describe("Number of persisted graph edges."),
+    evaluations: z
+        .array(z.object({
+        id: z.string(),
+        evalType: z.enum(["risk", "trust", "completeness", "value", "worth_buying"]),
+        score: z.number().nullable(),
+        summary: z.string().nullable(),
+        details: EvaluationDetailsSchema.nullable().describe("Structured inspection content (criterion scores, findings, strengths). Null for evaluations created before details were stored."),
+        evaluatedAt: z.number(),
+    }).strict())
+        .describe("Stored evaluation results (most recent first)."),
+    versions: z
+        .array(z.object({
+        version: z.string(),
+        description: z.string().nullable(),
+        createdAt: z.number(),
+    }).strict())
+        .describe("Project version history."),
 })
     .strict();
-const GetStageAssessmentResultSchema = z
+const AddObjectResultSchema = z
+    .object({ action: z.literal("add_object"), object: ProjectObjectSchema.describe("The added project-object relationship.") })
+    .strict();
+const RemoveObjectResultSchema = z
+    .object({ action: z.literal("remove_object"), removed: z.literal(true).describe("Always true — confirms removal.") })
+    .strict();
+const UpdateObjectResultSchema = z
     .object({
-    action: z.literal("get_stage_assessment"),
-    project: z.string(),
-    version: z.string(),
-    stage: z.number().int().min(1).max(5),
-    found: z.boolean(),
-    assessment: z
-        .object({
-        stage: z.number().int().min(1).max(5),
-        assessed_at: z.number().int(),
-        goal_completion: z.record(z.number()),
-        findings: z.array(z.object({
-            finding_id: z.string(),
-            severity: z.enum(["info", "warn", "critical"]),
-            criterion_id: z.string(),
-            description: z.string(),
-            evidence: z.unknown(),
-        })),
-        recommendations: z.array(z.string()),
-    })
-        .optional()
-        .describe("The stage assessment object (from assessment.json)."),
+    action: z.literal("update_object"),
+    object: ProjectObjectSchema.describe("The updated project-object relationship."),
 })
     .strict();
-const GetStageRiskPolicyResultSchema = z
+const CreateVersionResultSchema = z
     .object({
-    action: z.literal("get_stage_risk_policy"),
-    project: z.string(),
-    version: z.string(),
-    stage: z.number().int().min(1).max(5),
-    found: z.boolean(),
-    risk_policy: z
-        .object({
-        stage: z.number().int().min(1).max(5),
-        risks: z.array(z.object({
-            risk_id: z.string(),
-            category: z.enum([
-                "naming",
-                "dependency",
-                "operational",
-                "financial",
-                "security",
-            ]),
-            description: z.string(),
-            likelihood: z.enum(["low", "medium", "high"]),
-            impact: z.enum(["low", "medium", "high", "critical"]),
-            mitigation: z.string(),
-            owner: z.enum(["ai", "user", "system"]),
-        })),
-        active_controls: z.array(z.object({
-            control_id: z.string(),
-            control_type: z.enum(["preventive", "detective", "corrective"]),
-            target_risk: z.string(),
-            implementation: z.string(),
-            verified: z.boolean(),
-        })),
-        residual_risks: z.array(z.string()),
-    })
-        .optional()
-        .describe("The stage risk policy object (from risk-policy.json)."),
+    action: z.literal("create_version"),
+    version: z.object({
+        version: z.string().describe("Version tag (e.g. 'v2')."),
+        description: z.string().nullable(),
+        createdAt: z.number(),
+    }).strict(),
 })
     .strict();
-const GetDocRelationsResultSchema = z
+const BuildGraphResultSchema = z
     .object({
-    action: z.literal("get_doc_relations"),
-    project: z.string(),
-    version: z.string(),
-    found: z.boolean(),
-    relations: z
-        .object({
-        version: z.string(),
-        generated_at: z.number().int(),
-        project_invariants: z.array(z.object({
-            invariant_id: z.string(),
-            description: z.string(),
-            verified_by_stages: z.array(z.number().int()),
-        })),
-        stage_units: z.array(z.object({
-            stage: z.number().int().min(1).max(5),
-            goal_id: z.string(),
-            assessment_id: z.string(),
-            risk_policy_id: z.string(),
-            verification_id: z.string(),
-            artifacts: z.array(z.string()),
-        })),
-        derivations: z.array(z.object({
-            source_type: z.enum(["project_invariant", "project_goal"]),
-            source_id: z.string(),
-            target_type: z.enum(["stage_goal", "stage_risk", "stage_verification"]),
-            target_stage: z.number().int().min(1).max(5),
-            target_id: z.string(),
-            derivation_logic: z.string(),
-        })),
-        propagation_rules: z.array(z.object({
-            rule_id: z.string(),
-            trigger: z.object({
-                stage: z.number().int(),
-                event: z.enum(["verification_passed", "verification_failed"]),
-            }),
-            effect: z.object({
-                target: z.enum(["project_invariant", "next_stage"]),
-                action: z.enum(["verify", "block"]),
-            }),
-        })),
-        impact_map: z.record(z.array(z.string())),
-    })
-        .optional()
-        .describe("The validation chain graph (from relations.json)."),
+    action: z.literal("build_graph"),
+    nodeCount: z.number().describe("Total nodes in the constructed graph."),
+    edgeCount: z.number().describe("Total edges (after conflict resolution + dedup)."),
+    edgesBySource: z.record(z.string(), z.number()).describe("Edge counts by source: { internal: N, registrar: N, potential: N }."),
+    reputationCount: z.number().describe("Number of objects with Registrar reputation data."),
+    builtAt: z.number().describe("Build timestamp (ms)."),
 })
     .strict();
-const UpdateDeploymentDocResultSchema = z
+const GetGraphResultSchema = z
     .object({
-    action: z.literal("update_deployment_doc"),
-    project: z.string(),
-    version: z.string(),
-    updated: z.boolean().describe("Whether the deployment doc set was regenerated."),
-    updated_files: z
-        .array(z.string())
-        .describe("Project-relative paths of regenerated files."),
-    updated_file_count: z.number().int(),
-    all_stages_passed: z
-        .boolean()
-        .describe("Whether all stages passed their D-checks after the update."),
-    impact_summary: z
-        .object({
-        stages_affected: z.array(z.number().int()).describe("Stage numbers whose content changed."),
-        relations_rebuilt: z.boolean().describe("Whether relations.json was regenerated."),
-    })
-        .describe("Summary of what changed (based on relations.json impact analysis)."),
-    next_action: z
-        .enum(["validate_validation_chain", "trace_substeps", "none"])
-        .describe("Next action: validate the chain after update, or proceed to trace_substeps."),
+    action: z.literal("get_graph"),
+    edges: z.array(z.object({
+        sourceObject: z.string(),
+        targetObject: z.string(),
+        edgeSource: z.enum(["internal", "registrar", "potential"]),
+        relationshipType: z.string(),
+        fieldName: z.string().nullable(),
+        depth: z.number(),
+        verified: z.boolean(),
+        weight: z.number(),
+        direction: z.string().nullable(),
+    }).strict()).describe("Persisted graph edges."),
 })
     .strict();
-const ValidateValidationChainResultSchema = z
+const EvaluateProjectResultSchema = z
     .object({
-    action: z.literal("validate_validation_chain"),
-    project: z.string(),
-    version: z.string(),
-    valid: z
-        .boolean()
-        .describe("True when derivation, propagation, cross-stage, and impact-map checks all pass."),
-    derivation_checks: z.array(z.object({
-        check_id: z.string(),
-        status: z.enum(["pass", "fail", "warn"]),
-        message: z.string(),
-    })),
-    propagation_checks: z.array(z.object({
-        check_id: z.string(),
-        status: z.enum(["pass", "fail", "warn"]),
-        message: z.string(),
-    })),
-    cross_stage_checks: z.array(z.object({
-        check_id: z.string(),
-        status: z.enum(["pass", "fail", "warn"]),
-        message: z.string(),
-    })),
-    impact_map_checks: z.array(z.object({
-        check_id: z.string(),
-        status: z.enum(["pass", "fail", "warn"]),
+    action: z.literal("evaluate_project"),
+    evaluationType: z.enum(["risk", "trust", "completeness", "value", "worth_buying"]),
+    score: z.number().describe("Overall score (0-100, higher = better). 0 when needsLlm=true."),
+    summary: z.string(),
+    criterionScores: z.array(z.object({
+        name: z.string(), score: z.number(), weight: z.number(), rationale: z.string(),
+    }).strict()).describe("Per-criterion scores. Empty when needsLlm=true."),
+    findings: z.array(z.object({
+        criterion: z.string(),
+        severity: z.enum(["critical", "warning", "info"]),
         message: z.string(),
-    })),
-    blocking_issues: z.array(z.string()),
-    warnings: z.array(z.string()),
+        deduction: z.number(),
+    }).strict()).describe("Negative findings (deductions). Empty when needsLlm=true."),
+    strengths: z.array(z.string()).describe("Positive evidence. Empty when needsLlm=true."),
+    needsLlm: z.boolean().describe("True for worth_buying/value evaluations. When true, process the llmPrompt with an LLM and call save_evaluation to store the result."),
+    llmPrompt: z.string().optional().describe("Present when needsLlm=true. Send this prompt to an LLM, parse the JSON response, and call save_evaluation."),
+    evaluationId: z.string().describe("ID of the stored evaluation record (for rule-based types). Empty for LLM-assisted types."),
 })
     .strict();
-const ApplyImprovementResultSchema = z
+const SaveEvaluationResultSchema = z
     .object({
-    action: z.literal("apply_improvement"),
-    proposal_id: z.string(),
-    previous_status: z.string(),
-    new_status: z.string(),
-    applied: z
-        .boolean()
-        .describe("Whether the proposal was applied (true for approved+config_override, true for approved+source_patch producing patch file)."),
-    apply_mode: z.enum(["config_override", "source_patch"]),
-    override_file: z
-        .string()
-        .optional()
-        .describe("Path of the override file written (config_override only)."),
-    patch_file: z
-        .string()
-        .optional()
-        .describe("Path of the patch file written (source_patch only)."),
-    message: z.string(),
-    next_action: z
-        .enum(["get_improvement_queue", "get_flywheel_config", "none"])
-        .describe("Next action: check more proposals or view flywheel status."),
+    action: z.literal("save_evaluation"),
+    evaluation: z.object({
+        id: z.string(),
+        evalType: z.enum(["risk", "trust", "completeness", "value", "worth_buying"]),
+        score: z.number().nullable(),
+        summary: z.string().nullable(),
+        evaluatedAt: z.number(),
+    }).strict().describe("The stored evaluation record."),
 })
     .strict();
-const GetImprovementQueueResultSchema = z
+const CompareProjectsResultSchema = z
     .object({
-    action: z.literal("get_improvement_queue"),
-    total: z.number().int(),
-    filtered_count: z.number().int(),
-    proposals: z.array(z.object({
-        proposal_id: z.string(),
-        source_diagnosis_id: z.string(),
-        type: z.string(),
-        priority: z.string(),
-        automation: z.enum(["full", "semi", "manual"]),
-        apply_mode: z.enum(["config_override", "source_patch"]),
-        override_category: z.string().optional(),
-        title: z.string(),
-        description: z.string(),
-        target: z.string(),
-        review_status: z.enum(["pending", "approved", "rejected", "applied"]),
-        ab_test_recommended: z.boolean(),
-        persisted_at: z.string().optional(),
-        reviewed_at: z.string().optional(),
-    })),
-    summary: z.string(),
+    action: z.literal("compare_projects"),
+    evaluationType: z.enum(["risk", "trust", "completeness", "value", "worth_buying"]),
+    ranking: z.array(z.object({
+        projectId: z.string(),
+        projectName: z.string(),
+        score: z.number().nullable(),
+        summary: z.string().nullable(),
+        evaluatedAt: z.number().nullable(),
+    }).strict()).describe("Projects sorted by score descending (nulls last)."),
+    bestProjectId: z.string().nullable().describe("Project ID with the highest score, or null if none have evaluations."),
 })
     .strict();
-const GetFlywheelConfigResultSchema = z
+const RefreshObjectsResultSchema = z
     .object({
-    action: z.literal("get_flywheel_config"),
-    queue_path: z.string(),
-    overrides_dir: z.string(),
-    patches_dir: z.string(),
-    total_proposals: z.number().int(),
-    pending_count: z.number().int(),
-    approved_count: z.number().int(),
-    applied_count: z.number().int(),
-    rejected_count: z.number().int(),
-    override_files: z.array(z.string()),
-    recent_proposals: z.array(z.object({
-        proposal_id: z.string(),
-        type: z.string(),
-        priority: z.string(),
-        review_status: z.enum(["pending", "approved", "rejected", "applied"]),
-        title: z.string(),
-    })),
-    reflow_status: z
-        .enum(["active", "idle", "blocked"])
-        .describe("active=pending proposals exist; idle=no proposals; blocked=approved but not applied."),
+    action: z.literal("refresh_objects"),
+    refreshedCount: z.number().describe("Number of objects re-fetched from chain."),
+    failedCount: z.number().describe("Number of objects that failed to refresh."),
+    refreshedAt: z.number().describe("Refresh timestamp (ms)."),
 })
     .strict();
-const RollbackStageResultSchema = z
+const DeleteProjectResultSchema = z
     .object({
-    action: z.literal("rollback_stage"),
-    success: z.boolean().describe("Whether the rollback was executed (or would be, if dry_run=false)."),
-    dry_run: z.boolean().describe("Whether this was a policy evaluation only (no execution)."),
-    target_stage: z.number().int().min(1).max(5),
-    previous_stage: z.number().int().min(1).max(5),
-    allowed: z.boolean().describe("Whether the rollback is allowed by policy."),
-    block_reason: z.string().optional().describe("Present when allowed=false — explains why rollback is blocked."),
-    files_to_clean: z
-        .array(z.string())
-        .describe("Files/directories that will be (or were) deleted during rollback."),
-    files_cleaned: z
-        .array(z.string())
-        .describe("Files/directories actually deleted (empty in dry_run mode)."),
-    warnings: z.array(z.string()).describe("Non-blocking warnings (e.g., data loss reminder)."),
-    iteration_strategy: z.object({
-        strategy: z.enum(["in_place", "fork"]),
-        reason: z.string(),
-        fork_to_version: z.string().optional(),
-        published_objects: z.array(z.string()).optional(),
-    }),
-    message: z.string().describe("Human-readable summary."),
+    action: z.literal("delete_project"),
+    deleted: z.literal(true).describe("Always true — confirms deletion of the project and all associated objects, evaluations, versions, and graph edges."),
 })
     .strict();
-const GetReversibilityResultSchema = z
+const GetObjectDiffResultSchema = z
     .object({
-    action: z.literal("get_reversibility"),
-    query: z
-        .object({
-        object_type: z.string().optional(),
-        lifecycle_state: z.string().optional(),
-    })
-        .describe("The query parameters used (empty = full matrix returned)."),
-    entries: z.array(z.object({
-        object_type: z.string(),
-        lifecycle_state: z.enum(["created", "referenced", "published", "bound"]),
-        struct_reversible: z.enum(["reversible", "limited", "immutable"]),
-        behavior_reversible: z.boolean(),
-        gas_impact: z.enum(["low", "medium", "high", "none"]),
-        explanation: z.string(),
-    })),
-    total: z.number().int().describe("Number of matrix entries returned."),
+    action: z.literal("get_object_diff"),
+    address: z.string(),
+    fromTime: z.number(),
+    toTime: z.number(),
+    changedFields: z.array(z.object({
+        fieldPath: z.string().describe("Dotted field path (e.g. 'machine', 'sales[0].price')."),
+        oldValue: z.unknown().describe("Previous value (null if field was added)."),
+        newValue: z.unknown().describe("New value (null if field was removed)."),
+        changeType: z.enum(["added", "removed", "modified"]),
+    }).strict()).describe("Changed fields between the two timestamps."),
 })
     .strict();
-const AssembleContextResultSchema = z
+const GenerateDeploymentDocResultSchema = z
     .object({
-    action: z.literal("assemble_context"),
-    objects: z
-        .array(z.unknown())
-        .describe("Current on-chain states of the requested objects (from query_objects)."),
-    events: z
-        .array(z.unknown())
-        .optional()
-        .describe("Recent state-transition events (only when include_events=true). " +
-        "Includes NewOrderEvent, ProgressEvent, ArbEvent, etc."),
-    embedded_history: z
-        .record(z.string(), z.unknown())
-        .optional()
-        .describe("Operation history extracted from object states — NOT from tx queries. " +
-        "Progress objects: session.forwards (who did what, when, accomplished). " +
-        "Order objects: disputes, claimed_by, progress_object. " +
-        "This is the CORRECT history source: convergent, no infinite recursion."),
-    semantic_summary: z
-        .unknown()
-        .optional()
-        .describe("Business semantic annotations generated by buildDataSemantic — " +
-        "maps raw object fields to business-meaningful concepts for LLM consumption."),
-    context_digest: z
-        .string()
-        .describe("Unique digest for this assembled context (SHA of object IDs + versions + timestamp). " +
-        "Use for caching or to detect state changes between two assembly calls."),
-    next_action: z
-        .string()
-        .describe("Suggested next action: use onchain_transaction to verify a specific past tx, " +
-        "or proceed with onchain_operations to modify state, or re-call assemble_context " +
-        "after state changes."),
-    flywheel_collected: z
-        .object({
-        signature_recorded: z.boolean().describe("Whether the experience signature was recorded in the real-time experience layer."),
-        proposal_created: z.boolean().describe("Whether an improvement proposal was created for the offline distillation flywheel."),
-        proposal_id: z.string().optional().describe("The proposal ID, if created."),
-    })
-        .optional()
-        .describe("Distillation flywheel collection result. Non-blocking — may be undefined if collection fails. " +
-        "When present, the assembled context has been fed back into the experience layer and/or improvement queue."),
+    action: z.literal("generate_deployment_doc"),
+    markdown: z.string().describe("Generated deployment document markdown content (follows 71-deployment-list-spec)."),
+    validation: z.object({
+        valid: z.boolean().describe("True iff no D-check FAIL."),
+        checks: z.array(z.object({
+            check_id: z.string(),
+            description: z.string(),
+            status: z.enum(["PASS", "FAIL", "WARN"]),
+            notes: z.string().optional(),
+        }).strict()).describe("D-01..D-18 check results."),
+        errors: z.array(z.string()).describe("List of FAIL error messages."),
+    }).strict().describe("Deployment doc validation result against D-01..D-18."),
+    saved: z.boolean().describe("Whether the markdown was persisted to SQLite project_documents table."),
 })
     .strict();
 export const ProjectOperationOutputSchema = z
     .object({
     result: z.discriminatedUnion("action", [
-        ItemsResult("list_projects"),
-        ItemsResult("list_objects"),
-        ItemsResult("shareable"),
-        ItemsResult("dependencies"),
-        ItemsResult("referenced_by"),
-        z.object({
-            action: z.literal("pre_publish_check"),
-            warnings: z
-                .array(z.string())
-                .describe("Pre-publish warnings. Empty array means no issues detected."),
-        }),
-        ItemsResult("cross_project_refs"),
-        z.object({
-            action: z.literal("graph_stats"),
-            stats: z
-                .record(z.unknown())
-                .describe("Object dependency graph statistics (counts, depth, etc.)."),
-        }),
-        z.object({
-            action: z.literal("save_graph"),
-            saved: z.literal(true).describe("Always true — confirms the graph was saved."),
-            path: z.string().describe("Filesystem path where the graph was saved."),
-        }),
-        z.object({
-            action: z.literal("load_graph"),
-            loaded: z
-                .boolean()
-                .describe("Whether the graph was successfully loaded from disk."),
-        }),
-        AnalyzeIntentResultSchema,
-        AggregateRisksResultSchema,
-        GenerateDeploymentDocResultSchema,
-        TraceSubstepsResultSchema,
-        GetProjectStatusResultSchema,
-        LoadProjectResultSchema,
-        ForkProjectResultSchema,
-        ExportProjectResultSchema,
-        GetProjectFilesResultSchema,
-        ValidateStageUnitResultSchema,
-        GetStageAssessmentResultSchema,
-        GetStageRiskPolicyResultSchema,
-        GetDocRelationsResultSchema,
-        UpdateDeploymentDocResultSchema,
-        ValidateValidationChainResultSchema,
-        ApplyImprovementResultSchema,
-        GetImprovementQueueResultSchema,
-        GetFlywheelConfigResultSchema,
-        RollbackStageResultSchema,
-        GetReversibilityResultSchema,
+        ListProjectsResultSchema,
+        CreateProjectResultSchema,
+        CreateProjectFromOnchainResultSchema,
+        UpdateProjectResultSchema,
+        GetProjectDetailResultSchema,
+        AddObjectResultSchema,
+        RemoveObjectResultSchema,
+        UpdateObjectResultSchema,
+        CreateVersionResultSchema,
+        BuildGraphResultSchema,
+        GetGraphResultSchema,
+        EvaluateProjectResultSchema,
+        SaveEvaluationResultSchema,
+        CompareProjectsResultSchema,
+        RefreshObjectsResultSchema,
+        GetObjectDiffResultSchema,
+        DeleteProjectResultSchema,
         AssembleContextResultSchema,
+        GenerateDeploymentDocResultSchema,
     ]).describe("Query result — shape depends on action"),
 })
     .strict();