Komponenter

Uppgiftspipelinen

Håller en extern uppgiftstjänst i takt med valvets uppgiftsliggare. Valvet är sanningen; tjänsten är en spegel.

Pipelinen finns för att besvara en fråga: var bor en uppgift när du inte sitter i en session?

Valvets uppgiftsliggare är en fil. En fil är utmärkt på att vara protokollet och dålig på att vara nåbar från en telefon på ett tåg. Alltså behövs en andra yta — och i samma stund som en andra yta finns blir frågan vilken av de två som har rätt när de säger olika.

Valvet är sanningen. Tjänsten är en spegel.

Liggaren är källan. Den externa tjänsten håller en kopia av den, och kopian får ligga efter. Den får aldrig vara den man går till när de två skiljer sig.

Det är inte en preferens. Det följer av vad var och en kan bära: liggaren ligger intill mötesanteckningen som skapade uppgiften, i en mapp som också bär projektets konfiguration och dess historik. En uppgiftstjänst bär en titel och ett datum. Att stämma av mot den fattigare representationen förlorar det som gjorde uppgiften meningsfull.

Vilket är varför bara ett av pipelinens skript alls når den externa tjänsten. De övriga läser och skriver inne i valvet och lämnar det aldrig. En komponent vars nätyta är en fil av flera är en komponent vars felläge är litet.

Vad den läser och skriver

Kontraktet deklarerar det, och tabellen nedan renderas ur det i stället för att beskrivas här — samma regel som ramverket tillämpar på sig självt.

Att namnge tjänsten

Kontraktet säger an external task service, och gör rätt i det: pipelinen bryr sig inte om vilken, och en läsare som kör en annan uppgiftshanterare kör inte en annan design.

Den här sidan namnger Todoist eftersom en läsare inte kan bedöma en spegel utan att veta vad som speglas, och eftersom namngivningen inte kostar något — det är en kommersiell produkt vem som helst kan slå upp. Regeln sajten följer är att en sak namnges när läsaren kan gå och skaffa den, och hålls generisk när den bara finns på en enda persons maskiner.

Den här delen är inte publicerad

Pipelinen är en uppsättning lokala skript och de ligger inte i ett publikt repo. Rollen beskrivs här eftersom manualen beskriver hela systemet, inte bara de delar en läsare kan installera.

Två konsekvenser värda att säga rakt ut. Mönstret går att ta med även om koden inte gör det: en liggare i valvet, ett skript som speglar utåt, och en regel om vilken sida som vinner. Och nyckeln stannar där skriptet är — instrumentpanelen som bockar av en uppgift gör det genom att skriva i liggaren, inte genom att anropa tjänsten, och håller därför ingen egen API-nyckel.

Ur ecosystem.yaml, kontrakt 41 · core-skills 1.89.4 · läst vid bygge 2026-10-08