lazy-obsidian

lazy-obsidian

Plugin Claude Code pour la Méthode Lazy Obsidian — automatise les tâches de maintenance d'un vault Obsidian Cybersécurité (« CyberVault ») via 4 jobs idempotents qui tournent au démarrage de chaque session.

Vue d'ensemble

┌────────────────────┐
│ SessionStart hook  │  →  session-dispatcher.ps1  →  écrit dans le contexte de Claude :
└────────────────────┘                                "[lazy-obsidian] Jobs en retard : ..."
                                                        ↓
                                          Claude invoque /<skill> dans l'ordre
                                                        ↓
                ┌───────────────────────────────────────────────────────┐
                ▼                       ▼                ▼              ▼
          /cve-veille         /articles-veille     /moc-update    /audit-update
                ↓                       ↓                ↓              ↓
          NVD + CISA KEV         RSS Krebs/Bleeping/    _MOC.md      Audit.md
          → _Inbox/raw/cve/      CERT-FR                (additif)    (sentinelles
            (max 5 fichiers)     → _Inbox/raw/articles/              AUTO-START/END)
                                   (max 3, defuddle)
                                                        
          Tous écrivent : 99-Meta/lazy-obsidian-state.json (idempotence)
                          99-Meta/lazy-obsidian-runs.jsonl (audit trail)

Skills inclus

Skill	Description
cve-veille	Ingère ≤5 CVE critiques (CVSS≥7 OU CISA KEV) sur whitelist produit, depuis NVD/CISA
articles-veille	Ingère ≤3 articles RSS (Krebs, BleepingComputer, CERT-FR) avec scoring mots-clés
moc-update	Ajoute les pages statut: stable au _MOC.md (additif, jamais destructif)
audit-update	Recompte par cluster, réécrit la table entre <!-- AUTO-START --> et <!-- AUTO-END -->

Garanties communes

• Idempotence : si last_run.<skill> correspond à aujourd'hui (UTC), le job termine en SKIP_IDEMPOTENT.
• State persistant : 99-Meta/lazy-obsidian-state.json (seen_cves[], seen_urls[]).
• Audit trail : 99-Meta/lazy-obsidian-runs.jsonl (1 ligne JSON par run).
• Encoding UTF-8 BOM : tous les fichiers PS1 et tous les writes Markdown.
• Atomicité : .tmp + Move-Item -Force pour les writes critiques (MOC, Audit).
• Plafonds stricts : 5 CVE / 3 articles par run pour éviter la pollution de l'Inbox.

Installation

Méthode A — via marketplace local

/plugin marketplace add C:\dev\lazy-obsidian
/plugin install lazy-obsidian@lazy-obsidian

Méthode B — installation manuelle dans le vault

Copier le contenu de skills/ vers <vault>/.claude/skills/cybervault/ (les 4 skills CyberVault) et scripts/ vers <vault>/99-Meta/scripts/, puis configurer le hook SessionStart dans <vault>/.claude/settings.local.json :

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"<vault>\\99-Meta\\scripts\\session-dispatcher.ps1\""
          }
        ]
      }
    ]
  }
}

Pré-requis vault

Le plugin suppose la structure CyberVault :

<vault>/
├── _MOC.md                        # avec sections par cluster (## 🔴 Offensif, etc.)
├── _Inbox/
│   └── raw/
│       ├── cve/                   # cible cve-veille
│       └── articles/              # cible articles-veille
├── pages/
│   ├── 01-Concepts/<cluster>/
│   ├── 02-Technique/<cluster>/
│   └── 03-Gouvernance/<cluster>/
└── 99-Meta/
    ├── Schema.md                  # 16 clusters de référence
    ├── Audit.md                   # avec sentinelles <!-- AUTO-START --> <!-- AUTO-END -->
    ├── Fact-Check-Log.md
    ├── lazy-obsidian-state.json
    └── lazy-obsidian-runs.jsonl

État initial du state.json :

{
  "last_run": { "cve-veille": null, "articles-veille": null, "moc-update": null, "audit-update": null },
  "seen_urls": [],
  "seen_cves": [],
  "errors": []
}

Validation

scripts/validate-lazy-obsidian.ps1 exécute 12 checks structurels (dossiers, frontmatters, sentinelles, JSON valide). À lancer après installation puis périodiquement :

powershell -NoProfile -ExecutionPolicy Bypass -File "<vault>\99-Meta\scripts\validate-lazy-obsidian.ps1"

Sortie attendue : 12 OK / 0 WARN / 0 FAIL.

Usage manuel

Plutôt que d'attendre le hook SessionStart, on peut lancer un runner directement :

powershell -NoProfile -ExecutionPolicy Bypass -File "<vault>\99-Meta\scripts\runners\cve-veille.ps1"

Ou invoquer le skill via Claude : /cve-veille.

Limites volontaires (YAGNI)