kill-life-operator/README.md

Kill LIFE Operator for VS Code

Extension VS Code orientee operationnel pour relier plusieurs projets locaux et piloter les agents comme un cockpit d'execution, de runbooks et de prochaines actions.

Positionnement

Kill LIFE Operator est la version operationnelle du trio :

• Studio pour la construction produit.
• Mesh pour la coordination multi-repo.
• Operator pour l'execution, la supervision, les checks et les actions terrain.

Ce que fait cette extension

• Scanne chaque projet ouvert dans le workspace, plus les racines ajoutees manuellement.
• Detecte par defaut agents/*.md et .github/agents/*.md.
• Affiche les agents trouves dans une sidebar dediee.
• Permet d'ouvrir un prompt agent, de le copier, ou de l'inserer dans l'editeur courant.
• Expose un participant de chat @killops avec des commandes /agents, /pm, /architect, /firmware, /hw, /qa, /doc.

Par defaut, @killops repond avec un biais operationnel : etat courant, checks, incidents, runbooks, priorite d'action et etapes executables.

Demarrage rapide

npm install
npm run compile
npm run package:vsix

Ensuite dans VS Code :

1. Ouvre ce repo.
2. Lance F5 pour ouvrir une fenetre d'extension development host.
3. Dans la nouvelle fenetre, ouvre ton vrai workspace projet.
4. Si besoin, ajoute d'autres depots via la commande Kill LIFE Operator: Add Linked Project Root.

Utilisation

Sidebar

La vue Kill LIFE Operator liste les projets detectes puis les agents trouves.

• Clic sur un agent : ouvre son fichier Markdown.
• Menu contextuel : copie ou insere le prompt.

Chat

Dans le chat Copilot / agent de VS Code :

• @killops /agents : liste les projets et agents lies.
• @killops /firmware : aide a piloter l'execution cote firmware.
• @killops /hw : aide a cadrer les impacts hardware et les actions.
• @killops /qa : aide a definir checks, validations et evidence packs.
• @killops /doc : aide a produire runbooks, notes et passages de relais.
• @killops sans commande : agit comme cockpit operationnel.

Installation

Depuis un VSIX local

Le chemin recommande sur cette machine est l'installation via l'interface VS Code :

1. Genere le package avec npm run package:vsix.
2. Dans VS Code, ouvre Extensions: Install from VSIX....
3. Selectionne kill-life-operator-<version>.vsix.

Depuis le Marketplace

Les releases sont preparees pour le publisher electron-rare. Un tag vX.Y.Z publie automatiquement la meme archive .vsix sur GitHub Releases et sur le VS Code Marketplace des que le secret VSCE_PAT est disponible.

Release automation

Le workflow .github/workflows/extension-ci.yml execute :

• Pull requests et pushes sur main : npm ci, npm run check, npm run compile, npm run package:vsix.
• Tags v* : verification tag == v${package.json.version}, creation de GitHub Release, puis publication Marketplace.

Sequence de release :

1. Mets a jour package.json.
2. Commit et merge sur main.
3. Cree un tag vX.Y.Z qui correspond exactement au champ version.
4. Pousse le tag.

Marketplace setup

Avant la premiere publication Marketplace :

1. Cree le publisher electron-rare dans Visual Studio Marketplace / Azure DevOps.
2. Genere un Personal Access Token avec les permissions de publication Marketplace.
3. Ajoute ce token comme secret GitHub VSCE_PAT dans ce repo.

Commande utile :

gh secret set VSCE_PAT --repo electron-rare/kill-life-operator

Local multi-root smoke test

Le workspace de reference est partage dans ../kill-life-studio/kill-life-local-smoke.code-workspace.

Checklist de smoke test :

1. Installe les trois .vsix dans le meme profil VS Code.
2. Ouvre ../kill-life-studio/kill-life-local-smoke.code-workspace.
3. Verifie les trois entrees d'activity bar.
4. Lance Refresh Agents dans chaque extension.
5. Confirme que les agents de Kill_LIFE et Kill_LIFE/ai-agentic-embedded-base sont visibles.
6. Ouvre le chat et verifie @killops /agents, puis @killops /firmware ou @killops /qa.

Reglages

killLifeOperator.linkedProjectRoots

Liste de chemins absolus supplementaires a scanner, en plus des dossiers deja ouverts dans le workspace.

killLifeOperator.agentSearchPatterns

Globs utilises pour decouvrir les prompts d'agents dans chaque racine projet.

Valeurs par defaut :

[
  "agents/*.md",
  ".github/agents/*.md"
]