HTTP API: skills

Zdokumentovaný fakt: stránka, kterou web pro dovednost promítá.

use majordomus_cli::skill::SkillDocumented;
let d = SkillDocumented { documented: true, page: "site/content/skills/implement.md".into() };
assert!(d.page.ends_with("implement.md"));

Vynucený fakt: doktrína, která ověřuje dovednosti, a kontroly, které si změna této dovednosti vybere.

use majordomus_cli::skill::SkillEnforced;
let e = SkillEnforced { enforced: false, doctrine: None, gates: vec![] };
assert!(!e.enforced);

Co kniha důkazů může říci o testech dovednosti jako celku: nejslabší stav testů, které ji jmenují, nebo untested, když ji nejmenuje žádný.

use majordomus_cli::skill::SkillEvidence;
assert!(SkillEvidence::Proven.current());
assert!(SkillEvidence::InputsUnchanged.current());
assert!(!SkillEvidence::Stale.current());
assert!(SkillEvidence::Proven < SkillEvidence::Untested);

Jedna věc, kterou odvození shledalo špatnou, s příkazem, který ji urovná nebo reprodukuje.

use majordomus_cli::skill::{SkillFinding, SkillFindingLevel};
let f = SkillFinding {
    level: SkillFindingLevel::Fail,
    code: "untested".into(),
    skill: Some("implement".into()),
    subject: ".ai/repo/skills/implement/SKILL.md".into(),
    message: "no test names this skill".into(),
    reproduce: "majordomus skills explain implement".into(),
};
assert!(f.reproduce.contains("explain"));

Jak vážný je nález: selhání odmítne, varování se ohlásí.

use majordomus_cli::skill::SkillFindingLevel;
assert_ne!(SkillFindingLevel::Fail, SkillFindingLevel::Warn);

Jedno místo, odkud se dovednost vyvolává.

use majordomus_cli::skill::SkillInvocation;
let i = SkillInvocation {
    path: ".ai/repo/prompts/review.md".into(),
    line: 3,
    reference: "majordomus://skill/repo-review".into(),
};
assert_eq!(i.line, 3);

Odkud dovednost pochází, když nevznikla tady: neprůhledná značka do účetní knihy vedené mimo repozitář. Commitnutá polovina nepojmenovává žádný zdroj; záznam v knize, na který ukazuje, ho pojmenovává lokálně.

use majordomus_cli::skill::SkillProvenance;
let p = SkillProvenance {
    origin: "prior-art".into(),
    ledger: "import-2026-09-09#1".into(),
    decision: "adapted".into(),
};
assert!(p.ledger.starts_with("import-"));

Kde dovednost stojí, odvozeno ze čtyř faktů.

use majordomus_cli::skill::SkillStanding;
assert_eq!(SkillStanding::Orphan.label(), "orphan");

Jedna dovednost se vším, co o ní bylo odvozeno.

use majordomus_cli::skill::SkillStatus;
// every fact is always present in the answer, so a client never has to tell "absent"
// from "false"; only the provenance is optional
let schema = serde_json::to_value(schemars::schema_for!(SkillStatus)).unwrap();
let required = schema["required"].as_array().unwrap();
for field in ["id", "valid", "tested", "documented", "enforced", "used", "standing"] {
    assert!(required.iter().any(|f| f == field), "{field}");
}
assert!(!required.iter().any(|f| f == "provenance"));

Každá dovednost s odvozeným postavením a kolik jich stojí kde: co odpovídají majordomus skills status, GET /api/v1/skills a nástroj majordomus_skills.

use majordomus_cli::capability::builtin::skills::SkillStatusList;
let empty = SkillStatusList {
    count: 0,
    standings: std::collections::BTreeMap::new(),
    skills: vec![],
};
assert_eq!(empty.count, 0);

Jeden test, který jmenuje dovednost, a co o něm říká kniha.

use majordomus_cli::evidence::ProofState;
use majordomus_cli::skill::SkillTest;
let t = SkillTest {
    path: "test/cases/95_skills.sh".into(),
    test: Some("suite:95_skills".into()),
    state: ProofState::NotRun,
    reproduce: Some("bash test/run.sh 95_skills".into()),
    recorded_at: None,
};
assert_eq!(t.state, ProofState::NotRun);

Otestovaná skutečnost: testy, které dovednost jmenují, a jejich nejslabší stav.

use majordomus_cli::skill::{SkillEvidence, SkillTested};
let t = SkillTested { state: SkillEvidence::Untested, tests: vec![] };
assert!(!t.state.current());

Použitý fakt: každý povrch vyvolání, který se na dovednost odkazuje.

use majordomus_cli::skill::SkillUsed;
let u = SkillUsed { used: false, invocations: vec![] };
assert!(!u.used);

Verdikt nad každou dovedností: platné, pokud žádný nález neodmítá.

use majordomus_cli::capability::builtin::skills::SkillVerification;
let v = SkillVerification { valid: true, skills: 3, failures: 0, warnings: 2, findings: vec![] };
// warnings are debts, reported; they do not make the verdict false
assert!(v.valid);