mesh-delivery/modules/mesh-delivery-view/cmd/mesh-delivery-view-tools/main.go

// Command mesh-delivery-view-tools serves the read tools of the indexer's modules (novox/hq issue 1562): the runtime launches it for a
// call, it reads the indexer's modules bucket through the view's reads (mesh-delivery-indexer.modules) and writes nothing.
// The view is the other program: the indexer serves no tool (ADR 0437 §4).
package main

import (
	"encoding/json"
	"fmt"
	"os"

	stdio "git.novox.be/novox/mesh-sdk/go"
	"mesh-delivery-view/internal/view"
)

// Tools are the read tools over a modules state.
func Tools(r view.Reader) []stdio.Tool {
	return []stdio.Tool{
		{Name: view.ModuleReadTool,
			Description: "What the indexer stored for one module under modules.<module>, as stored: its fingerprint (fp, none), the " +
				"new-form fingerprint (fp2) or why it has none (none2), the inputs it was computed from (inputs2), the module's " +
				"directory (path) and the toolchains it was computed with. Read-only.",
			Input: map[string]any{"type": "object", "required": []string{"module"}, "properties": map[string]any{
				"module": map[string]any{"type": "string", "description": "the module's name"}}},
			Run: func(args map[string]any) (any, error) {
				name, _ := args["module"].(string)
				return r.Module(name)
			}},
		{Name: view.ModulesReadTool,
			Description: "Every module the indexer holds, each as stored under modules.<module>. With none2 true, only the modules " +
				"that have no new-form fingerprint, each with the reason (none2). Read-only.",
			Input: map[string]any{"type": "object", "properties": map[string]any{
				"none2": map[string]any{"type": "boolean", "description": "only the modules without a new-form fingerprint"}}},
			Run: func(args map[string]any) (any, error) {
				only, _ := args["none2"].(bool)
				mods, err := r.Modules(only)
				return map[string]any{"modules": mods}, err
			}},
		{Name: view.BuilderBuildsReadTool,
			Description: "The builder's build keys, each as stored in mesh-delivery-builder_builds: key, module, fingerprint (src2) and build " +
				"(state, by, step with the nodes it was built on, manifest, artifacts with their digests, toolchains, error). Narrow by module " +
				"or state (queued, building, done, failed). Read-only.",
			Input: map[string]any{"type": "object", "properties": map[string]any{
				"module": map[string]any{"type": "string", "description": "only this module's builds"},
				"state":  map[string]any{"type": "string", "description": "only builds in this state"}}},
			Run: func(args map[string]any) (any, error) {
				module, _ := args["module"].(string)
				state, _ := args["state"].(string)
				rows, err := r.BuilderBuilds(module, state)
				return map[string]any{"builds": rows}, err
			}},
		{Name: view.BuilderBuildReadTool,
			Description: "One build of the builder as stored. Give the module and its fingerprint (fp2, src2:...), or the module alone for the build " +
				"at the fingerprint the indexer holds for it now, joined through modules.<module>; with commit, only if the indexer holds the module at that commit. Read-only.",
			Input: map[string]any{"type": "object", "required": []string{"module"}, "properties": map[string]any{
				"module": map[string]any{"type": "string", "description": "the module's name"},
				"fp2":    map[string]any{"type": "string", "description": "its new-form fingerprint; empty means the indexer's current one"},
				"commit": map[string]any{"type": "string", "description": "the commit the indexer must hold the module at"}}},
			Run: func(args map[string]any) (any, error) {
				module, _ := args["module"].(string)
				fp2, _ := args["fp2"].(string)
				commit, _ := args["commit"].(string)
				return r.BuilderBuild(module, fp2, commit)
			}},
	}
}

func read(state stdio.KeptState) view.StateRead {
	return view.StateRead{Keys: state.Keys, Get: func(key string) (json.RawMessage, error) {
		e, err := state.Get(key)
		if err != nil || e == nil {
			return nil, err
		}
		return e.Value, nil
	}}
}

func main() {
	r := view.Reader{State: read(stdio.State("mesh-delivery-indexer.modules")), Builds: read(stdio.State("mesh-delivery-builder.builds"))}
	if err := stdio.Serve("", Tools(r)); err != nil {
		fmt.Fprintf(os.Stderr, "[mesh-delivery-view-tools] %v\n", err)
		os.Exit(1)
	}
}