certify_research

Vue d’ensemble

certify_research scanne quatre types de sources et scelle chaque entrée nouvelle ou modifiée :

• Obsidian — vault local, frontmatter YAML avec status: reviewed
• Notion — base de données, propriété Status = “reviewed”
• Jira — worklogs sur les issues d’un projet ou via JQL custom
• N8N — workflows tagués (savoir-faire process)

Chaque entrée est hashée en SHA-512, stockée au ledger, et scellée chez IP Secure si configuré (certificat eIDAS Certigna).

Note

Détection des doublons basée sur le fingerprint du contenu canonique : le même contenu ne sera pas scellé deux fois, quelle que soit la source.

Astuce

Essentiel pour les crédits d’impôt R&D (CIR/CII). Le rapport effort_report --format valorisation exploite les heures certifiées pour produire les indicateurs CIR.

Parameters

project string requis

ID du projet a certifier. Doit correspondre au champ project dans le frontmatter (Obsidian) ou a la propriete Title (Notion). Le projet doit avoir vault_path et/ou notion_database_id configure.

since string défaut: 7 days ago

ISO date string. Only certify notes modified after this date.

dry_run boolean

Mode preview. Défaut : true si IP Secure est lié au projet, false sinon.

Quand true, renvoie un preview de ce qui serait scellé sans rien persister.

Attention

Le certificat eIDAS fige title/description/asset_types au moment du scellement réel. Toujours présenter le preview à l’utilisateur et obtenir confirmation EXPLICITE avant dry_run: false.

asset_types string[] défaut: ["programme_rnd"]

Types d’actifs IP. Defaut : ["programme_rnd"] pour les notes de recherche.

Autres valeurs possibles : savoir_faire, logiciel, base_donnees.

Obsidian Note Format

Notes must have YAML frontmatter with these required fields:

---
project: my-project      # Must match the project parameter
date: 2026-01-16         # Research date
hours: 2.5               # Effort in hours
class: S                 # S=Strategic, A=Advanced, C=Common
status: reviewed         # Must NOT be "draft"
---

# Research Content

Your research notes here...

Class Levels

Class	Description	Tax Credit Multiplier
S	Strategic - Novel research, breakthrough	Highest
A	Advanced - Complex problem solving	Medium
C	Common - Standard development	Base

Attention

Notes with status: draft are automatically skipped. Change to reviewed when ready to certify.

Response

{
  "ipsecure_enabled": true,
  "project_auto_created": false,
  "certified": 5,
  "skipped": 2,
  "total_hours": 12.5,
  "attestations": [
    {
      "file": "research/2026-05-16-feature-analysis.md",
      "source": "obsidian",
      "hours": 2.5,
      "class": "S",
      "fingerprint": "476b712a0658003cd68931ca49f8c6e2...",
      "ipsecure_contribution_id": "mwMWTpjmu3",
      "ipsecure_certificate_url": null
    }
  ],
  "errors": []
}

Note

ipsecure_certificate_url est souvent null à la réponse immédiate (Jinnove génère le certificat de façon asynchrone). Récupérer plus tard avec fetch_certificate(ledger_id).

Workflow

1. Preview with dry_run

   Certify research for project "my-project" with dry_run enabled

   Review the list of notes that will be certified.

2. Check Hours

   Verify total_hours is reasonable. Flag if > 40h/week.

3. Certify

   Certify research for project "my-project"

   Remove dry_run to create actual attestations.

4. Récupérer les certificats eIDAS plus tard

   Pour chaque entrée scellée avec IP Secure, appeler fetch_certificate(ledger_id) après quelques minutes pour récupérer l’URL du PDF Certigna.

Examples

Preview Certification

MCP Prompt

Certify research notes for project "seshat" since 2026-01-01 with dry_run enabled

Response

{
  "project": "seshat",
  "certified": 0,
  "would_certify": 8,
  "total_hours": 24.5,
  "dry_run": true,
  "notes": [
    {
      "file": "research/mcp-architecture.md",
      "hours": 4,
      "class": "S",
      "status": "would_certify"
    }
  ]
}

Actual Certification

MCP Prompt

Certify research notes for project "seshat"

Response

{
  "ipsecure_enabled": true,
  "certified": 8,
  "total_hours": 24.5,
  "attestations": [
    {
      "file": "research/mcp-architecture.md",
      "source": "obsidian",
      "fingerprint": "476b712a0658003cd68931ca49f8c6e2...",
      "ipsecure_contribution_id": "mwMWTpjmu3",
      "ipsecure_certificate_url": null
    }
  ],
  "errors": []
}

Astuce

Le champ source distingue l’origine : obsidian, notion, jira, n8n. Utile pour les rapports CIR qui ventilent l’effort par type de source.

Avertissements

Attention

High hours: If total_hours > 40 per week, the agent should flag this as unusually high.

Attention

Missing frontmatter: Notes without required frontmatter fields are skipped with an error reason.

Attention

Already certified: Notes with the same fingerprint are skipped (duplicate protection).

Format base Notion

Si vous utilisez Notion comme source de recherche, votre base doit avoir ces proprietes :

Propriete	Type Notion	Requis	Equivalent frontmatter
project	Title	Oui	project
date	Date	Oui	date
hours	Number	Oui	hours
class	Select	Non	class (S/A/C)
status	Select	Non	status (draft/reviewed/certified)
objective	Rich text	Non	objective
tags	Multi-select	Non	Tags

Attention

Utilisez le type Select pour status, pas le type natif “Status” de Notion (lecture seule via API).

Astuce

Voir le guide Notion Integration pour les instructions completes et le detail du hashing canonique.

Best Practices

1. Certify weekly to maintain a continuous proof chain
2. Use meaningful class levels - S for breakthroughs, C for routine work
3. Keep detailed notes - they’re part of your legal evidence
4. Review before certifying - dry_run is your friend
5. Combinez les sources - Obsidian pour les notes locales, Notion pour la recherche collaborative