Janady13/missionmatch / internal/modules/staffing/config.go

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/missionmatch / internal/modules/staffing/config.go
Date	Not specified in source
Repository	Janady13/missionmatch
Revision	720d47fae476b0d38477ae4401697d372b1ea2bc
Branch	feature/opportunity-to-outcome
Path or archive member	internal/modules/staffing/config.go
Original SHA-256	ec62d54da20e97e052b800ed176e5e490c111f8007a2413b32c24d2d80a0d768
Git blob SHA	773d8a0e103e38b7c14c0c4a9c22ec7fad4025a8
Reading-copy SHA-256	ec62d54da20e97e052b800ed176e5e490c111f8007a2413b32c24d2d80a0d768

Original source ↗

Every recorded occurrence

These 24 records contain identical original source bytes. Their paths and revisions remain part of the archive.

Original record	Branch or archive	Revision / identifier	Original location
Janady13/missionmatch / internal/modules/staffing/config.go	feature/opportunity-to-outcome	720d47fae476b0d38477ae4401697d372b1ea2bc	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	per-tenant-routing	9bde0f9a74b89d01980fa658e5253acda7528d0c	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	collision-deconfliction	4ee5a09972608ed89f8377c6665542d5f450f0a6	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws6-retrieval	6c56e29231ec05735927fa265c97d517499dfeaf	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	m5-price-to-win	41000ad30fff4129fdaf5ec84e15ba14c27d4890	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws1-ontology-sync	b596f449a32a1016fbd403c36505cc00a1ac9ee6	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	master	1e9249840a4302ec82e123b9c9cb6f75badea3e4	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws8-teaching-loop	c823f0fb6bb2aba0f39001eb6de96f4000d9321f	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	w3-ai-staffing-recommendations	43d56387270ef4da4cabd794d97ca6a49909bc7d	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	mag-substrate	b82c7100a492dec67dfd1eda6b3f53def859be35	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws3-clearance	4b8e7ce594c068621867f9c9deed0ec64ae6c553	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	phase2-eval-fairness	d361af254701975fe239927656ababb56374655e	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	time-to-fill-survival	b66e1e505863d4f17741a4b9ede73509e45bd6c6	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	graphrag-foundation	b0ddeb9f633fd138d09309d1a17b7d13bc3a67f7	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	deploy-and-ops	bdacd9d0b4d5998d25fc74bf4007f4c3ec538c7a	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws9-bench-ingestion	f585a9ef32fa554663ce1fba9a414a54b6e49cf0	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws2-alias-relationship	e4dada4601c6eb101830f9d223a9655dfa120616	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	presentation-readiness	eb574acaa29d71ce4d0f852572e87c275c79fdb7	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	vendor-intelligence	fe9796a19c261951d3f2565206c0c1b5ac294465	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ws7-federal-signal	6a9f6ce9cfb13345ffb47770d4960e7c2d9c17c2	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	ai-brain-live	aac32fc49c878cc5bca099459307611562d0bac1	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	phase2-connectors	e038d4c687aec16f8bd9bc4d907eea14d91f8704	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	feature/aioe-upgrade	2178e7298d0e5d9af83afa12402fd587f0ba6ed8	Open original
Janady13/missionmatch / internal/modules/staffing/config.go	capture-readiness	bae6af7cb2997e819174a9e9cfff5e16067a1975	Open original

Recovered source transcript

Download complete source text ↓129 lines · 4.9 KB

package staffing

import (
	"os"
	"strconv"
	"time"

	"github.com/shopspring/decimal"
)

// Config holds the W3 tunables. Every value is a GLOBAL platform default (see Load, which reads optional
// MM_W3_* environment variables). The staffing floor and the adjacency threshold may ADDITIONALLY be
// overridden per run through the request body, and the values actually used are recorded in
// recommendation_runs.parameters so a run is reproducible and auditable. Per org configuration is a future
// addition; v1 is global defaults plus per run override of the floor and the adjacency threshold.
type Config struct {
	// StaffingFloor is the minimum engine total a candidate must reach to be qualified for assignment.
	// Default 75, the Yellow band floor. A candidate below the floor is never an assign or reassign; the
	// optimizer and the classifier only ever arbitrate among candidates the engine already qualified.
	StaffingFloor decimal.Decimal
	// AdjacencyThreshold is the maximum cosine distance for a held skill to count as adjacent to a missing
	// required skill (the reskill path). Default 0.40 (roughly cosine similarity 0.60).
	AdjacencyThreshold decimal.Decimal

	// Confidence is a deterministic transparency aid in [0,1], a weighted blend of fit, clearance
	// provenance, and profile completeness. The three weights sum to 1.
	ConfidenceFitWeight          decimal.Decimal // default 0.60
	ConfidenceProvenanceWeight   decimal.Decimal // default 0.25
	ConfidenceCompletenessWeight decimal.Decimal // default 0.15

	// Value function. The optimizer objective is an int64 so the solve is integer exact and FIPS clean.
	ValueScalePrecision int64           // fixed integer scale applied to the real valued objective; default 1_000_000
	ValueReference      decimal.Decimal // the opportunity dollar value that maps to the midpoint priority; default 5_000_000
	PriorityMin         decimal.Decimal // minimum priority multiplier; default 1
	PriorityMax         decimal.Decimal // maximum priority multiplier; default 3

	// Optimizer envelope (denial of service guard on our own API): a portfolio solve that exceeds either
	// bound is refused with a typed error, never run unbounded.
	MaxProblemEdges int           // max candidate by requirement edges; default 250_000
	MaxProblemNodes int           // max graph nodes; default 5_000
	SolveBudget     time.Duration // per solve wall clock budget enforced by a context deadline; default 5s

	// ProactiveBestFitLimit caps the best fit opportunities returned per candidate in the proactive view.
	ProactiveBestFitLimit int // default 5
	// ReadPageMax caps a single page of recommendation reads.
	ReadPageMax int // default 200
}

// DefaultConfig returns the documented global defaults.
func DefaultConfig() Config {
	return Config{
		StaffingFloor:                decimal.NewFromInt(75),
		AdjacencyThreshold:           decimal.RequireFromString("0.40"),
		ConfidenceFitWeight:          decimal.RequireFromString("0.60"),
		ConfidenceProvenanceWeight:   decimal.RequireFromString("0.25"),
		ConfidenceCompletenessWeight: decimal.RequireFromString("0.15"),
		ValueScalePrecision:          1_000_000,
		ValueReference:               decimal.NewFromInt(5_000_000),
		PriorityMin:                  decimal.NewFromInt(1),
		PriorityMax:                  decimal.NewFromInt(3),
		MaxProblemEdges:              250_000,
		MaxProblemNodes:              5_000,
		SolveBudget:                  5 * time.Second,
		ProactiveBestFitLimit:        5,
		ReadPageMax:                  200,
	}
}

// Load returns DefaultConfig with any MM_W3_* overrides applied. Unset or unparseable variables keep the
// default, so a misconfigured env never silently disables a guard.
func Load() Config {
	c := DefaultConfig()
	if v := envDecimal("MM_W3_STAFFING_FLOOR"); v != nil {
		c.StaffingFloor = *v
	}
	if v := envDecimal("MM_W3_ADJACENCY_THRESHOLD"); v != nil {
		c.AdjacencyThreshold = *v
	}
	if v := envDecimal("MM_W3_VALUE_REFERENCE"); v != nil && v.GreaterThan(decimal.Zero) {
		c.ValueReference = *v
	}
	if n := envInt("MM_W3_MAX_PROBLEM_EDGES"); n > 0 {
		c.MaxProblemEdges = n
	}
	if n := envInt("MM_W3_MAX_PROBLEM_NODES"); n > 0 {
		c.MaxProblemNodes = n
	}
	if n := envInt("MM_W3_SOLVE_BUDGET_MS"); n > 0 {
		c.SolveBudget = time.Duration(n) * time.Millisecond
	}
	return c
}

// WithOverrides returns a copy of the config with a per run staffing floor and adjacency threshold
// applied when supplied (non nil). The caller validates the ranges before calling.
func (c Config) WithOverrides(floor, adjacency *decimal.Decimal) Config {
	if floor != nil {
		c.StaffingFloor = *floor
	}
	if adjacency != nil {
		c.AdjacencyThreshold = *adjacency
	}
	return c
}

func envDecimal(key string) *decimal.Decimal {
	s := os.Getenv(key)
	if s == "" {
		return nil
	}
	d, err := decimal.NewFromString(s)
	if err != nil {
		return nil
	}
	return &d
}

func envInt(key string) int {
	s := os.Getenv(key)
	if s == "" {
		return 0
	}
	n, err := strconv.Atoi(s)
	if err != nil {
		return 0
	}
	return n
}