# 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

```bash
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`](.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 :

```bash
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 :

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