Function pendingRelatedModule

engine/server/session_workspaces.go:799–831

pendingRelatedModule adapts a related module of a primary module into the existing pendingModule loading path. Related modules are modules attached through the primary module source's blueprint or toolchains. They are resolved separately from regular dependencies but still need the same legacy comp

(
	defaultPathContextSrc dagql.ObjectResult[*core.ModuleSource],
	related *core.ModuleSource,
	cfg *modules.ModuleConfigDependency,
	entrypoint bool,
)

// already resolving +defaultPath through another source, it is that outer
// ContextSource.
func pendingRelatedModule(
	defaultPathContextSrc dagql.ObjectResult[*core.ModuleSource],
	related *core.ModuleSource,
	cfg *modules.ModuleConfigDependency,
	entrypoint bool,
) pendingModule {
	mod := pendingModule{
		Ref:        related.AsString(),
		RefPin:     related.Pin(),
		Entrypoint: entrypoint,
		// LegacyDefaultPath is intentionally not set here. Related modules
		// are loaded as siblings of an explicit -m entrypoint: their
		// +defaultPath must resolve against that entrypoint's repo (the
		// -m argument), not against the session's currentWorkspace — the
		// latter is the user's CWD, which may be empty, partial, or a
		// different checkout entirely.
	}
	if defaultPathContextSrc.Self() != nil {
		mod.DefaultPathContextSourceRef = defaultPathContextSrc.Self().AsString()
		mod.DefaultPathContextSourcePin = defaultPathContextSrc.Self().Pin()
	}
	if cfg != nil {
		if cfg.Name != "" {
			mod.Name = cfg.Name
		}
		mod.ConfigDefaults = workspace.ExtractConfigDefaults(cfg.Customizations)
		mod.ArgCustomizations = cfg.Customizations
	}
	if entrypoint && defaultPathContextSrc.Self() != nil && defaultPathContextSrc.Self().Kind == core.ModuleSourceKindLocal {
		mod.LegacyCallerModuleDir = defaultPathContextSrc.Self().AsString()
	}
	return mod
}

func (srv *Server) resolveModuleSourceAsModule(
	ctx context.Context,