MysStaffingOS Internal
MysStaffingOS Internal is de centrale ingang naar de private ontwikkeltools van
Mysolution. Via deze extensie haal je de agents, skills en bijbehorende tooling
op die je nodig hebt in je dagelijkse werk, en blijf je automatisch bij met de
laatste versies.
Eerst aanmelden
Deze extensie is alleen bedoeld voor collega's die zijn aangemeld voor het
MysStaffingOS Program. De aanmelding geeft je toegang tot de private
Mysolution GitHub-organisatie, waar de inhoud van de tools wordt beheerd.
Zonder die toegang kun je de extensie wel vanuit de VS Code Marketplace
installeren, maar geen private tools installeren of bijwerken. Vraag toegang aan
via het MysStaffingOS Program voordat je verdergaat.
Wat je krijgt
- Een centrale plek voor Mysolution agents, skills, prompts en ontwikkeltools.
- Installatie van de tools die voor jou beschikbaar zijn in de catalogus.
- Een automatische updatecontrole bij het starten van VS Code.
- Een consistente werkwijze voor Business Central, Salesforce en volgende
Mysolution-platforms.
De catalogus bevat Mysolution Business Central Dev Tools, Mysolution
Consultancy Tools en Mysolution Product Owner Tools. Andere tools worden via dezelfde ingang beschikbaar zodra
ze aan de catalogus zijn toegevoegd en je MysStaffingOS Internal hebt bijgewerkt.
Aan de slag
- Meld je aan voor het MysStaffingOS Program en ontvang toegang tot de
private Mysolution GitHub-organisatie.
- Installeer MysStaffingOS Internal vanuit de VS Code Marketplace.
Ontbreekt de GitHub CLI (
gh), kies dan Install GitHub CLI in de
installatiemelding.
- Open de Command Palette en kies MysStaffingOS Internal: Extensie
installeren....
- Vink alleen de tools aan die je nodig hebt (standaard staat niets
aangevinkt). De extensie downloadt en installeert de juiste private release.
De VS Code CLI (code) moet beschikbaar zijn op je PATH.
Aanmelden bij GitHub (SSO-wizard)
Mysolution gebruikt GitHub Enterprise. Is de GitHub CLI nog niet aangemeld, of
heeft het account geen (SSO-)toegang tot de private tools, dan start vóór een
installatie of update automatisch een wizard. Je kunt hem ook zelf starten met
MysStaffingOS Internal: Aanmelden bij GitHub (SSO)....
- SSO-pagina: de wizard opent https://github.com/enterprises/mysolution/sso.
Log daar in met je Mysolution Microsoft-account, niet met een zelf
aangemaakt/persoonlijk GitHub-account.
- Eenmalige code: de wizard start
gh auth login op de achtergrond en toont
een code. Klik Kopieer code en open browser, kies in de accountkiezer het
account waarmee je net via SSO bent ingelogd, plak de code en klik op
Authorize.
- Controle: de wizard controleert of je de private releases kunt lezen. Lukt
dat niet (bijvoorbeeld nog geen SSO-autorisatie), dan begint hij opnieuw bij
stap 1 met uitleg.
Een omgevingsvariabele GH_TOKEN/GITHUB_TOKEN gaat voor op de CLI-aanmelding;
verwijder die en herstart VS Code als de wizard daarom vraagt. Bij de automatische
updatecontrole bij het opstarten verschijnt geen wizard, maar een melding met de
knop Aanmelden bij GitHub.
Op Windows zoekt de facade code.cmd op je PATH en gebruikt het volledige
pad. Deze correctie is beschikbaar sinds 0.1.17. Daardoor kan de CLI zijn
eigen VS Code-installatie vinden, ook bij paden met spaties.
Bij een mislukte CLI-controle staat de onderliggende fout in het outputkanaal
MysStaffingOS Internal; dit betekent niet automatisch dat VS Code ontbreekt.
Een fout zoals '"...\Microsoft VS Code\bin\..\Code.exe"' is not recognized
betreft het lokaal starten van de VS Code CLI, niet je GitHub-account of
SSO-toegang. Het pad in die fout verwijst naar de Code.exe die de CLI probeert
te starten (bin\.. is de bovenliggende installatiemap). Controleer of die
Code.exe daar aanwezig is. De melding alleen bewijst niet waarom het starten
mislukt.
Werk een oudere MysStaffingOS Internal eerst bij en herlaad VS Code. Blijft de
fout bestaan, deel dan de volledige CLI-fout en de extensieversie met support.
Ontbreekt Code.exe op het getoonde installatiepad, laat de VS Code-installatie
controleren of herstellen. Opnieuw aanmelden bij GitHub verhelpt deze lokale
startfout niet.
GitHub CLI als gedeelde prerequisite
MysStaffingOS Internal controleert bij het starten of gh werkt. Als de CLI
ontbreekt, vraagt de extensie toestemming om deze te installeren:
- Windows: via
winget (pakket GitHub.cli). Hiervoor moet App Installer
beschikbaar zijn; Windows kan om beheerderstoestemming vragen.
- macOS: via
brew install gh, als Homebrew al beschikbaar is.
- Linux en andere platforms: installeer de CLI zelf volgens
https://cli.github.com/. Een bestaande werkende CLI wordt gewoon gebruikt.
De eerste installatiewizard, handmatige toolinstallaties en updatecontroles wachten
op dezelfde lopende prerequisite-installatie. Je kunt dus meteen een tool kiezen,
ook als de eerste setup nog bezig is. Er wordt pas verdergegaan als gh --version
daadwerkelijk werkt, niet alleen omdat het installatieprogramma succes meldt.
Na installatie zoekt de extensie opnieuw in de standaard Windows- en
Homebrew-installatiemappen. Daardoor kan de private toolinstallatie in hetzelfde
VS Code-venster doorgaan, ook als de proces-PATH nog niet is bijgewerkt.
Bij annuleren, een ontbrekende package manager of een mislukte installatie krijg
je herstelstappen. Voer daarna het installatie- of updatecommando opnieuw uit.
Bij een handmatige installatie op een afwijkende locatie: controleer je PATH
en sluit VS Code volledig af voordat je opnieuw probeert.
Voor Mysolution Business Central Dev Tools is toegang tot
mysolutionsoftware/Agentic-BC-dev nodig. De extensie-id blijft
mysolution.business-central-dev-tools; alleen de distributierepository verandert.
Voor Mysolution Consultancy Tools moet je GitHub-account toegang hebben tot
de private repository MyStaffingOS/Agentic-Consultancy. Alleen toegang tot de
Business Central-repository is daarvoor niet voldoende. Kies Mysolution
Consultancy Tools via Extensie installeren..., ook als je de Business
Central-tools al hebt geinstalleerd.
Updates
Bij iedere start van VS Code controleert MysStaffingOS Internal de geinstalleerde
private tools op een nieuwere release. Een nieuwere versie wordt automatisch
geinstalleerd als de controles slagen. Je kunt ook handmatig
MysStaffingOS Internal: Controleren op updates uitvoeren vanuit de Command
Palette.
Mysolution Product Owner Tools is een lege Claude-stijl plugintemplate voor
product owners. Er zijn nog geen inhoudelijke agents, skills of commands.
Claude Code en VS Code gebruiken dezelfde plugininhoud.
Je GitHub-account moet toegang hebben tot mysolutionsoftware/Agentic-productowners;
het gekoppelde team Development-MSR heeft write-rechten op deze repository.
Werk MysStaffingOS Internal bij, herlaad VS Code en kies de tool via
Extensie installeren... zodra deze cataloguswijziging is gepubliceerd.
Lokale Business Central-aanpassingen
Voor iedere BC-update controleert de facade de actieve installatie via de VS Code
extensions-API en alle BC-versiemappen in de betrokken extensions-directory.
Hiervoor is PowerShell 7 (pwsh) nodig. De controle gebruikt de meegeleverde
vsix/contributions/Invoke-CustomizationContribution.ps1 met -Action Detect en
-InstalledPath <extensiemap>/mysolution, naast de bijbehorende baseline.json en
config.json. Deze bestanden komen uit de geinstalleerde extensie, niet uit een
workspace of de nieuwe release.
Bij lokale aanpassingen wordt de update uitgesteld zonder bestanden te
overschrijven. Contribute Customizations start uitsluitend het bestaande
businessCentralDevTools.contributeCustomizations-commando van de actieve
installatie. Bijdragen blijven via Azure DevOps lopen, niet via GitHub.
Cancel of het sluiten van de melding laat de installatie ongemoeid.
De update wordt na een bijdrage niet automatisch hervat; controleer de afhandeling
van je aanpassingen en probeer daarna opnieuw.
Ook onbekende, gewijzigde of onvolledig verpakte oudere installaties blokkeren de
update: de CLI kan zelf oude versies opruimen. Aanpassingen in een inactieve map
moeten apart veiliggesteld en ingediend worden; het bijdragecommando verwerkt
alleen de actieve installatie. De facade verwijdert geen BC-versiemappen en
wijzigt hun .obsolete-markeringen niet. Bestaande VS Code-opruimacties buiten deze
facade vallen niet onder deze bescherming.
Een ontbrekende engine/baseline, detectiefout of versie-/padverschil blokkeert de
update met een foutmelding; er is geen optie om toch te overschrijven. De baseline
moet bij de geinstalleerde versie horen: 0.2.BuildId blijft geldig voordat
naar 0.3.x wordt bijgewerkt. Een echte eerste installatie zonder oude BC-mappen
vereist geen bijdrage-engine of pwsh. Consultancy gebruikt deze BC-controle niet.
Releasecontract en lokale verificatie
De catalogus blijft gebundeld in de facade. Alleen stabiele GitHub-releases met
een vX.Y.Z-tag worden geselecteerd, met precies een VSIX waarvan prefix en
versie overeenkomen (business-central-dev-tools-X.Y.Z.vsix voor BC).
Nieuwe BC-releases gebruiken 0.3.x, zodat ze boven de oude 0.2.BuildId-versies
sorteren. Dit verandert niets aan het bijdragekanaal.
Voer in src/Global VSIX npm run package:vsix uit voor de volledige lokale
testreeks en een VSIX in artifacts. Tests gebruiken tijdelijke fixtures en
gemockte CLI-aanroepen; ze installeren geen tools/extensies en melden niemand aan.
Alleen de bestaande publicatieworkflow beheert de volgende Marketplace-versie.
Lokaal verpakken publiceert of installeert niets.
