Janady13/missionmatch / internal/modules/matching/skillmatcher.go

Source identity

Field	Recorded value
Source type	GitHub source
Original record	Janady13/missionmatch / internal/modules/matching/skillmatcher.go
Date	Not specified in source
Repository	Janady13/missionmatch
Revision	09015496d565a172bcaa15cfe9a8e4b072b13df0
Branch	workstream-b-screenmatch
Path or archive member	internal/modules/matching/skillmatcher.go
Original SHA-256	c2e57f3998fdb51512146793c08673a94373881fc12d96b23a774069faece045
Git blob SHA	c9bc41bd9a3ae9ba7215f8b9d749e9927f1a3922
Reading-copy SHA-256	c2e57f3998fdb51512146793c08673a94373881fc12d96b23a774069faece045

Original source ↗

Every recorded occurrence

These 23 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/matching/skillmatcher.go	workstream-b-screenmatch	09015496d565a172bcaa15cfe9a8e4b072b13df0	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-a-opportunity-intelligence	1675031db74316e100782d063e9eda1a597fe3a1	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-d-command-center	255e7d1d420abf5e277d0cd8c9b14f6f72b6acb9	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-d-missionmatch	3be46ba89edb737182075a2b320509b42dc916f8	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-e-dataflow-deploy	433815a042f9741411e60fa553fe72143e9b10db	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	w3-ai-staffing-recommendations	43d56387270ef4da4cabd794d97ca6a49909bc7d	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-e-commercial-stubs	4437da660539284a400ee380b9b427a300c369ee	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-c-slatematch	5cd60c918301b46ecd6ed3e03e20c395da0062e2	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	ai-intelligence-layer	5d5ddff70393a197c5f54a45280bb5dd42b24755	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	ruthless-debug-sweep	b7d742f8f032984be3817efffa3eb8b13b651c1f	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-b-sam-contract-awards	d5101cceb98e70000cebb31d3e7ac73d747d3a6d	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-a-shared-core	e0de03ac3a1ec826bd15d0e048e3b02baa23eeff	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-c-slatematch	5cd60c918301b46ecd6ed3e03e20c395da0062e2	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	w3-ai-staffing-recommendations	43d56387270ef4da4cabd794d97ca6a49909bc7d	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-d-command-center	255e7d1d420abf5e277d0cd8c9b14f6f72b6acb9	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-e-dataflow-deploy	433815a042f9741411e60fa553fe72143e9b10db	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	ruthless-debug-sweep	b7d742f8f032984be3817efffa3eb8b13b651c1f	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	ai-intelligence-layer	5d5ddff70393a197c5f54a45280bb5dd42b24755	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-a-opportunity-intelligence	1675031db74316e100782d063e9eda1a597fe3a1	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-b-screenmatch	09015496d565a172bcaa15cfe9a8e4b072b13df0	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-e-commercial-stubs	4437da660539284a400ee380b9b427a300c369ee	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-d-missionmatch	3be46ba89edb737182075a2b320509b42dc916f8	Open original
Janady13/missionmatch / internal/modules/matching/skillmatcher.go	workstream-b-sam-contract-awards	d5101cceb98e70000cebb31d3e7ac73d747d3a6d	Open original

Recovered source transcript

Download complete source text ↓79 lines · 2.8 KB

package matching

import (
	"context"

	"github.com/shopspring/decimal"

	"github.com/missionworkforce/missionmatch/internal/modules/matching/engine"
	"github.com/missionworkforce/missionmatch/internal/platform/embeddings"
)

// EmbeddingSkillMatcher implements engine.SkillMatcher using the embedding provider: it embeds the
// required skill name and each candidate skill name and picks the best cosine match at/above the
// engine's threshold. Vectors from the provider are L2-normalized, so cosine == dot product.
//
// This is the semantic ("synonyms / adjacent skills") layer the engine defers to AFTER exact match.
// With the deterministic offline embedder, unrelated skills score near zero, so it never invents a
// false semantic match, exact matching still dominates. Determinism follows from the embedder's.
type EmbeddingSkillMatcher struct {
	embedder embeddings.Embedder
}

// NewEmbeddingSkillMatcher wraps an embedder as an engine.SkillMatcher.
func NewEmbeddingSkillMatcher(e embeddings.Embedder) *EmbeddingSkillMatcher {
	return &EmbeddingSkillMatcher{embedder: e}
}

// Match satisfies engine.SkillMatcher. It returns the candidate skill side and the similarity; the
// engine owns the required-side identity and the match flags. ctx is the request context, so an
// embedding provider call respects the request deadline and cancellation (it is never stored).
//
// The float dot product picks the single best candidate (ordering ties are astronomically unlikely
// and never change the met/unmet outcome), but the at or above threshold DECISION is made in decimal
// on the similarity rounded to a fixed scale, so the boundary outcome is reproducible across
// architectures, on the engine's determinism path.
func (m *EmbeddingSkillMatcher) Match(ctx context.Context, required engine.RequiredSkill, cands []engine.CandidateSkill, threshold decimal.Decimal) (engine.SkillMatch, bool) {
	if m == nil || m.embedder == nil || len(cands) == 0 {
		return engine.SkillMatch{}, false
	}
	rv, err := m.embedder.Embed(ctx, required.Name)
	if err != nil {
		return engine.SkillMatch{}, false
	}

	bestSim := -2.0
	var best engine.CandidateSkill
	found := false
	for _, cs := range cands {
		cv, err := m.embedder.Embed(ctx, cs.Name)
		if err != nil || len(cv) != len(rv) {
			continue
		}
		if sim := dot(rv, cv); sim > bestSim {
			bestSim, best, found = sim, cs, true
		}
	}
	if !found {
		return engine.SkillMatch{}, false
	}
	sim := decimal.NewFromFloat(bestSim).Round(4)
	if sim.LessThan(threshold) {
		return engine.SkillMatch{}, false
	}
	return engine.SkillMatch{
		CandidateSkillID: best.SkillID,
		CandidateName:    best.Name,
		Similarity:       sim,
		Matched:          true,
	}, true
}

func dot(a, b []float32) float64 {
	var s float64
	for i := range a {
		s += float64(a[i]) * float64(b[i])
	}
	return s
}