978052b5a2
Fix B of the pre-#59 semantic correction. The Silent Pass had only TWO effective states though the data
carries three: a `detected` mapping (a concrete artifact) AND a `partial` mapping (an indicative signal,
e.g. a CI pipeline -> secure-development-lifecycle) both flowed through capability_ids() and were fed to
the Advisor as already-present — so a weak indication silently removed a question, exactly the Welt-1/
Welt-2 transparency we want to keep.
Now three distinct states:
- detected -> reduces the delta immediately (auto_detected, not asked). [unchanged]
- partial -> raises assumption strength but does NOT replace the question (surfaced as `indications`,
the capability stays in the delta and is still asked).
- requirement-> describes a target, never the present state (already handled by Fix A's kind split).
Changes (data + thin wiring, no new architecture):
- SilentIntakeResult.capability_ids() returns only relationship==detected; new indicative_capability_ids()
returns the partial ones.
- advisor_start() gains indicative_capabilities (NOT fed into the profile) and surfaces result.indications
= indicative ∩ required − auto_detected.
- AdvisorResult / AdvisorResponse gain `indications` (additive, contract-safe); the service passes the
indicative ids through.
Tests: a partial CI signal is indicative-not-detected and does NOT shrink the delta; end-to-end it appears
in `indications`, not `auto_detected`, and the gap is still asked. 28 onboarding tests pass, mypy --strict
clean on the onboarding modules, demo runs, check-loc 0. Runtime effect -> deploy + smoke.
65 lines
2.8 KiB
Python
65 lines
2.8 KiB
Python
"""Schemas for the Smart Onboarding Advisor — the onboarding RUNTIME step.
|
|
|
|
DTOs only. The Advisor ORCHESTRATES the existing engines (Company 2A, RS-005, optimization,
|
|
completeness) — no new reasoning engine, no new capability registry, no new meta-model. Welt-1
|
|
discipline: a certificate yields PROBABLE capabilities (verification required), never "erfüllt".
|
|
Python 3.9 compatible (no `|` unions).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import List, Optional
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class OnboardingInput(BaseModel):
|
|
company: str = ""
|
|
industry: Optional[str] = None
|
|
products: List[str] = Field(default_factory=list)
|
|
markets: List[str] = Field(default_factory=list)
|
|
certifications: List[str] = Field(default_factory=list)
|
|
known_evidence: List[str] = Field(default_factory=list)
|
|
target: List[str] = Field(default_factory=list) # informational; the delta uses injected requirements
|
|
|
|
|
|
class InferredAssumption(BaseModel):
|
|
certification: str
|
|
capabilities: List[str] = Field(default_factory=list) # RELEVANT-to-target caps the cert probably provides
|
|
verification_required: bool = True # Welt-1: never auto-satisfied
|
|
statement: str = ""
|
|
|
|
|
|
class RejectedAssumption(BaseModel):
|
|
certification: Optional[str] = None
|
|
statement: str = ""
|
|
reason: str = "" # e.g. "relevance(evidence, target) = 0"
|
|
|
|
|
|
class AdvisorQuestion(BaseModel):
|
|
capability_id: str
|
|
question_intent: str
|
|
why: str # every question explains itself
|
|
information_value: float = 0.0 # deterministic rank score
|
|
priority: str = "medium"
|
|
|
|
|
|
class AdvisorMeasure(BaseModel):
|
|
capability_id: str
|
|
leverage: int = 0
|
|
closes: List[str] = Field(default_factory=list)
|
|
|
|
|
|
class AdvisorResult(BaseModel):
|
|
inferred_assumptions: List[InferredAssumption] = Field(default_factory=list)
|
|
rejected_assumptions: List[RejectedAssumption] = Field(default_factory=list)
|
|
auto_detected: List[str] = Field(default_factory=list) # detected (concrete artifact): recognised w/o asking
|
|
indications: List[str] = Field(default_factory=list) # partial signal: raises assumption strength, STILL asked
|
|
next_best_questions: List[AdvisorQuestion] = Field(default_factory=list) # max 5
|
|
capability_delta: List[str] = Field(default_factory=list)
|
|
top_measures: List[AdvisorMeasure] = Field(default_factory=list)
|
|
evidence_requests: List[str] = Field(default_factory=list)
|
|
unsupported_domains: List[str] = Field(default_factory=list)
|
|
completeness_summary: str = ""
|
|
headline: str = "" # "N erkannt, M wahrscheinlich abgedeckt, K zu klären"
|