Change register

Anomalies, features, improvements and discoveries: record, sort, promote and resolve them.

evolution_add

effortless_evolution_add — Stability: stable · project

Records a product evolution (type, title, detail, status, reporter, criticality, priority). born_marker (optional): a stable text fragment naming the defect in the git-tracked code; supplied during a work item, it makes the entry be refused if the defect was born from that work (fix it inside). The response carries implication: the suggested verbs, never triggered automatically.

💬 You ask your agent

« Log a bug "CSV export loses accents" with criticality 2, priority 1. »

→ The agent callseffortless_evolution_add

• type = Anomalie
• title = CSV export loses accents
• criticality = 2
• priority = 1

Name	Type	Required	Description
type	string	yes	Marker of the evolution: Découverte, Fonctionnalité, Amélioration, Anomalie or Test. Required.
title	string	yes	Title of the evolution. Required.
detail	string	no	Detail text (default empty).
status	string	no	Initial status: Planifié (default), En cours, En Attente, Résolu or Retiré; an active entry whose type quota is full (except Anomalie) is stored as En Attente.
reporter	string	no	Person or agent reporting the entry (free text, optional).
criticality	string	no	Criticality level, an integer from 1 to 3 where 1 is the most urgent; absent leaves the entry unranked.
priority	string	no	Priority level, an integer from 1 to 3 where 1 is the most urgent; absent leaves the entry unranked.
born_marker	string	no	Stable text fragment naming the defect in the code tracked by git (refusal code, function name, test name). When given, the engine checks whether the defect already existed at the first commit of the active story and refuses the entry if it was born in that work; absent, the entry is accepted with an unclassified note.

evolution_depends_on

effortless_evolution_depends_on — Stability: beta · project

Declares what an evolution's graduation must wait for: it is pushed back in the order until the target is closed, without being removed or discounted. An absent or empty target clears the dependency. Refuses an unknown target, a self-dependency and any cycle, at write time.

💬 You ask your agent

« Evolution 26FCT001 must not start before epic 012 is closed: declare that dependency. »

→ The agent callseffortless_evolution_depends_on

• evo_id = 26FCT001
• target = 012

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution that waits. Required.
target	string	no	Id of the evolution or epic whose closure releases it; absent or empty removes the dependency.

evolution_edit

effortless_evolution_edit — Stability: beta · project

Corrects an evolution: criticality, priority and detail. The previous detail revision is kept append-only in detail_revisions, never overwritten. A terminal status (Resolved or Retired) does not prevent the correction. Does not touch the title, status or type. Refuses a call with no field.

💬 You ask your agent

« Raise evolution 26FCT001 to criticality 1 and replace its detail with: "Also affects the import." »

→ The agent callseffortless_evolution_edit

• evo_id = 26FCT001
• criticality = 1
• detail = Also affects the import.

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution to correct. Required.
criticality	string	no	New criticality level, an integer from 1 to 3 where 1 is the most urgent.
priority	string	no	New priority level, an integer from 1 to 3 where 1 is the most urgent.
detail	string	no	Corrected detail text; the previous revision is kept in detail_revisions.

evolution_graduate

effortless_evolution_graduate — Stability: stable · project

Promotes an evolution to an epic: attaches it to the existing epic epic_id, or creates one (and activates it) from zone (+ title, description). Creates no story.

💬 You ask your agent

« Graduate evolution 26FCT001 into an epic in the "reports" zone, titled "Reliable export". »

→ The agent callseffortless_evolution_graduate

• evo_id = 26FCT001
• zone = rapports
• title = Reliable export

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution to promote. Required.
zone	string	no	Functional zone of the epic to create; required when epic_id is absent.
title	string	no	Title of the epic to create (default: derived from the evolution id); ignored when epic_id is given.
epic_id	string	no	Id of an existing epic to link the evolution to; absent, a new epic is created from zone and activated.
description	string	no	Description of the epic to create (default empty); ignored when epic_id is given.

evolution_list

effortless_evolution_list — Stability: stable · project

Read-only. Lists the evolutions of the project registry, with an optional status or text filter and an optional compact form.

💬 You ask your agent

« List the evolutions with status "Planifié" (planned). »

→ The agent callseffortless_evolution_list

• status = Planifié

Name	Type	Required	Description
status	string	no	Exact status filter: Planifié, En cours, En Attente, Résolu or Retiré; absent applies no status filter.
query	string	no	Case-insensitive substring searched in id, title and detail only; absent or empty applies no text filter.
form	string	no	Shape of the response: full (default) or compact ({id, status, title, epic}).

evolution_migrate_levels

effortless_evolution_migrate_levels — Stability: beta · project

Rewrites the registry's legacy levels: converts recognizable free values to integers, maps "Medium" to level 2 (open entries that carried it become Pending, never closed ones) and names in its report every value it could not convert. Idempotent: replayed, it touches nothing.

💬 You ask your agent

« Migrate the registry's legacy criticality and priority levels to integers. »

→ The agent callseffortless_evolution_migrate_levels

No parameters.

evolution_migrate_markers

effortless_evolution_migrate_markers — Stability: beta · project

Converts the type field of each legacy evolution (finding, need, improvement, overhaul, workstream) to one of the five deterministic markers. Idempotent; no id changes.

💬 You ask your agent

« Convert the evolution registry's legacy types to the five current markers. »

→ The agent callseffortless_evolution_migrate_markers

No parameters.

evolution_queue

effortless_evolution_queue — Stability: beta · project

Read-only. The registry queue: active entries already sorted by the engine key (unmet dependency, then criticality, priority, age, id), bounded and filterable by status and type. Answers "what to pick up next". Compact form, without detail or resolution; an entry is then read by its id. The total is returned next to the window, so a truncated queue is not mistaken for a short one.

💬 You ask your agent

« Which evolution should we pick up next? Give me the first five in the queue. »

→ The agent callseffortless_evolution_queue

• limit = 5

Name	Type	Required	Description
status	string	no	Keep only one status; absent returns the queue of active entries.
type_	string	no	Keep only one marker: Découverte, Fonctionnalité, Amélioration, Anomalie or Test.
limit	integer	no	Size of the window, capped at 200 (default 25).

evolution_requalify

effortless_evolution_requalify — Stability: beta · project

Requalifies an evolution between Anomaly and Improvement only; refuses any other pair of current marker and target. The id never changes.

💬 You ask your agent

« Evolution 26FCT002 ("Excel export") is actually an improvement, not a bug: requalify it as Amélioration. »

→ The agent callseffortless_evolution_requalify

• evo_id = 26FCT002
• marker = Amélioration

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution to requalify. Required.
marker	string	yes	Target marker: Anomalie or Amélioration only (the entry must currently carry the other one). Required.

evolution_resolve

effortless_evolution_resolve — Stability: beta · no project

Resolves an evolution without requiring an epic. A reason is required. Refuses, by name, a terminal status or an unknown id.

💬 You ask your agent

« Mark evolution 26FCT001 as resolved: "Fixed in v1.4.1." »

→ The agent callseffortless_evolution_resolve

• evo_id = 26FCT001
• note = Fixed in v1.4.1.

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution to resolve. Required.
note	string	yes	Reason for the resolution; without it a closed evolution cannot be told from a forgotten one. Required.

evolution_retire

effortless_evolution_retire — Stability: stable · project

Explicitly dismisses an evolution (status Retired); a reason is required. Works even on an already graduated evolution, unlike the plain removal reserved for items with no follow-up yet. Never sets Resolved.

💬 You ask your agent

« Retire evolution 26FCT001, reason: the need disappeared when the Excel export was dropped. »

→ The agent callseffortless_evolution_retire

• evo_id = 26FCT001
• reason = The need disappeared when the Excel export was dropped.

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution to retire. Required.
reason	string	yes	Reason for the retirement, always required. Required.

evolution_set_ready

effortless_evolution_set_ready — Stability: beta · project

Sets or clears ready_to_graduate on an evolution. Refuses on a terminal status (Resolved or Retired), like evolution_retire.

💬 You ask your agent

« Mark evolution 26FCT001 as ready to graduate into an epic. »

→ The agent callseffortless_evolution_set_ready

• evo_id = 26FCT001
• ready = true

Name	Type	Required	Description
evo_id	string	yes	Id of the evolution. Required.
ready	boolean	yes	New value of the ready_to_graduate flag. Required.