Saltar al contenido principal

Corregir

Cambiar lo que daimon arrastra: cerrar, reafirmar, enmendar, refutar y fijar reglas.

nota

Esta página se genera a partir de los parsers de argumentos de la CLI. No la edites: cambiá el flag o su texto de ayuda en el código y corré UPDATE_DOCS_REFERENCE=1 uv run pytest tests/test_docs_generated.py desde plugin/. El texto de cada flag está en inglés porque es el que imprime la CLI.

Ver también: Corregir la memoria, Reglas y checks, Ciclo de vida, Reglas, Conocimiento negativo.

daimon resolve​

mark a checkpoint item resolved: append-only event, folds at read so the item stops carrying (#102)

daimon resolve target [--status STATUS] [--note NOTE] [--by agent] [--evidence EVIDENCE] [--project PROJECT] [--dry-run]
argumentovalorpor defectodescripción
targetitem id (exact) or a query that must match exactly one item
--statusSTATUSresolvedfree-form lifecycle status (default: resolved; a status starting with 'reopen' revives the item)
--noteNOTEoptional context recorded on the event
--byagentdeclare an agent-initiated claim (requires --evidence); omit for the human path (default)
--evidenceEVIDENCEverbatim transcript quote proving the claim: required with --by agent, rejected without it
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--dry-runshow what would resolve without writing an event: look before the write (#304)

Ejemplos

daimon resolve o-3f8a2c
daimon resolve "release pipeline approval" --note "shipped in 0.9"

daimon reverify​

evidence-gated human reopen of a resolved item (#103): requires an interactive terminal and refuses without proof

daimon reverify target [--evidence EVIDENCE] [--project PROJECT]
argumentovalorpor defectodescripción
targetitem id (exact only: reverify is deliberate, no fuzzy match)
--evidenceEVIDENCEwhy this claim can be trusted again
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

Ejemplos

daimon reverify o-3f8a2c --evidence "checked release page"
daimon reverify o-3f8a2c # reopens only if the anchor still checks live
daimon reverify o-3f8a2c # rejects an unconfirmed supersede candidate: no evidence needed

daimon trust​

record or settle a human quarantine on a checkpoint value (#1109): an active one is withheld from every read, and is published to the team when one is enabled

daimon trust <command>
comandoqué hace
proposepropose a quarantine; agent proposals stay candidates until a human confirms or dismisses them
confirmactivate a candidate quarantine as a human decision
dismissreject a candidate quarantine as a human decision
releaselift an active quarantine as a human decision
republishre-send this project's active and released quarantines to the team sidecar; a human act, safe to repeat
listlist project quarantines, candidates first
repairalias for daimon ledger repair trust: heal trust.jsonl and re-run forget over it
showshow one quarantine record

Ejemplos

daimon trust propose --text "the runbook was fabricated" --kind decision --reason "no matching PR" --evidence issue:1109 --by agent
daimon trust confirm tr-0123456789ab
daimon trust release tr-0123456789ab

daimon trust propose​

propose a quarantine; agent proposals stay candidates until a human confirms or dismisses them

daimon trust propose --text TEXT --kind belief|contradiction|decision|question|topic|uncertainty --reason REASON --evidence EVIDENCE [--item-id ITEM_ID] [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
--textTEXTthe checkpoint value to quarantine, verbatim (obligatorio)
--kindbelief|contradiction|decision|question|topic|uncertaintywhich checkpoint field kind this concerns (obligatorio)
--reasonREASONwhy this value is unsafe to act on (obligatorio)
--evidenceEVIDENCEtyped evidence source (repeatable): message:<id>, transcript:<session>, artifact:<path>, issue:<number>, measurement:<receipt>, receipt:<id>, url:<source> (obligatorio)
--item-idITEM_IDthe checkpoint item id this was observed on (an accelerator only: identity is the value, not this id)
--byagentdeclare yourself an agent; omit it only from an interactive terminal, which is the human path and lands active immediately
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon trust confirm​

activate a candidate quarantine as a human decision

daimon trust confirm quarantine_id [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
quarantine_idexact tr-… id
--byagentdeclare yourself an agent; confirm then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon trust dismiss​

reject a candidate quarantine as a human decision

daimon trust dismiss quarantine_id [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
quarantine_idexact tr-… id
--byagentdeclare yourself an agent; dismiss then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon trust release​

lift an active quarantine as a human decision

daimon trust release quarantine_id [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
quarantine_idexact tr-… id
--byagentdeclare yourself an agent; release then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon trust republish​

re-send this project's active and released quarantines to the team sidecar; a human act, safe to repeat

daimon trust republish [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
--byagentdeclare yourself an agent; republish then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon trust list​

list project quarantines, candidates first

daimon trust list [--project PROJECT] [--json] [--team]
argumentovalorpor defectodescripción
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output
--teamlist the quarantines teammates published instead: kind and count anywhere, author directory and ts at a terminal

daimon trust repair​

alias for daimon ledger repair trust: heal trust.jsonl and re-run forget over it

daimon trust repair [--project PROJECT] [--dry-run]
argumentovalorpor defectodescripción
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--dry-runreport what would change and write nothing

daimon trust show​

show one quarantine record

daimon trust show quarantine_id [--project PROJECT] [--json]
argumentovalorpor defectodescripción
quarantine_idexact tr-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon anchor​

resolve a code symbol to an anchor block for a cognitive item

daimon anchor file symbol [--project PROJECT] [--attach TEXT-MATCH]
argumentovalorpor defectodescripción
filerepo-relative path to the source file
symbolsymbol name or Class.method
--projectPROJECTproject root the file is relative to (default: cwd)
--attachTEXT-MATCHattach the anchor to the one checkpoint item whose text contains TEXT-MATCH (case-insensitive), re-writing the latest checkpoint

Ejemplos

daimon anchor daimon_briefing/cli.py _cmd_brief
daimon anchor pkg/mod.py MyClass.method --project .
daimon anchor pkg/mod.py fn --attach 'auth decision'

daimon refute​

author and query evidence-cited negative knowledge (#573)

daimon refute <command>
comandoqué hace
addassert a scoped refutation; agent assertions stay candidates
ratifyexplicitly activate a candidate as a human decision
reviseappend a new evidence-cited version; inactive until ratified
overturnend a refutation: a candidate as rejected, an active one as retired; agent calls propose, humans deactivate
showshow one refutation and its trust signals
listlist project refutations
searchsearch the complete ledger without age decay
guardcheck active refutations by exact anchor or subject phrase

Ejemplos

daimon refute list
daimon refute search receipt verification
daimon refute guard 'should we revisit #502?'

daimon refute add​

assert a scoped refutation; agent assertions stay candidates

daimon refute add --subject SUBJECT --verdict VERDICT --scope SCOPE --evidence SOURCE [--anchor ANCHOR] [--revisit-when REVISIT_WHEN] [--by agent] [--ratify] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
--subjectSUBJECTapproach or claim rejected (obligatorio)
--verdictVERDICTwhat no longer holds (obligatorio)
--scopeSCOPEwhere the verdict applies (obligatorio)
--evidenceSOURCEcited measurement, artifact, issue, or transcript source; recorded verbatim, not resolved or verified; repeatable (obligatorio)
--anchorANCHORstable exact-match key such as issue:502 or command:daimon-why; repeatable
--revisit-whenREVISIT_WHENcondition that makes reconsideration legitimate
--byagentdeclare yourself an agent; omit it only from an interactive terminal, which is the human path
--ratifyactivate immediately; valid only on the human path, which is an interactive terminal with no --by.
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

Ejemplos

daimon refute add --subject 'original #502 receipt design' --verdict 'whole-file hashes do not prove span claims' --scope 'carried-item receipt tiers' --anchor issue:502 --evidence 'measurement:566/623 origin misses' --ratify

daimon refute ratify​

explicitly activate a candidate as a human decision

daimon refute ratify refutation_id [--by agent] [--note NOTE] [--project PROJECT] [--slug SLUG] [--json]
argumentovalorpor defectodescripción
refutation_idexact r-… id
--byagentdeclare yourself an agent; ratification then refuses, because activation requires a human channel
--noteNOTEoptional ratification rationale
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)
--jsonmachine-readable output

daimon refute revise​

append a new evidence-cited version; inactive until ratified

daimon refute revise refutation_id [--subject SUBJECT] [--verdict VERDICT] [--scope SCOPE] [--anchor ANCHOR] [--revisit-when REVISIT_WHEN] --evidence SOURCE [--by agent] [--ratify] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
refutation_idexact r-… id
--subjectSUBJECTreplacement subject
--verdictVERDICTreplacement verdict
--scopeSCOPEreplacement scope
--anchorANCHORreplacement anchor set; repeatable
--revisit-whenREVISIT_WHENreplacement revisit condition
--evidenceSOURCEnew evidence cited for the revision; recorded, not verified; repeatable (obligatorio)
--byagent
--ratifyactivate the revision immediately; valid only on the human path, which is an interactive terminal with no --by.
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon refute overturn​

end a refutation: a candidate as rejected, an active one as retired; agent calls propose, humans deactivate

daimon refute overturn refutation_id [--evidence SOURCE] [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG] [--json]
argumentovalorpor defectodescripción
refutation_idexact r-… id
--evidenceSOURCEevidence cited against the verdict; required for an active refutation, not for a candidate; recorded, not verified; repeatable
--noteNOTEoptional explanation
--byagent
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)
--jsonmachine-readable output

daimon refute show​

show one refutation and its trust signals

daimon refute show refutation_id [--project PROJECT] [--json]
argumentovalorpor defectodescripción
refutation_idexact r-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon refute list​

list project refutations

daimon refute list [--state active|candidate|overturned] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
--stateactive|candidate|overturnedfilter by state; repeatable
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

search the complete ledger without age decay

daimon refute search query ... [--state active|candidate|overturned] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
querysubject, verdict, scope, or anchor terms
--stateactive|candidate|overturnedfilter by state; repeatable
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon refute guard​

check active refutations by exact anchor or subject phrase

daimon refute guard query ... [--anchor ANCHOR] [--project PROJECT] [--json] [--quiet]
argumentovalorpor defectodescripción
querythe proposed approach or user prompt
--anchorANCHORcandidate action anchor; repeatable
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output
--quietprint nothing when no active refutation matches

daimon ruling​

standing rulings: human-ratified records that never decay (#693)

daimon ruling <command>
comandoqué hace
proposepropose a standing ruling; agent proposals stay candidates until a human ratifies
ratifyactivate a candidate ruling; prints the full text and confirms before the append
reviserevise a ruling; on an active ruling an agent call records a proposal and the text stands
retireend a ruling: a candidate as rejected, an active one as retired; agent calls propose, humans retire directly; evidence optional
checkthe check a ruling carries (#943): try it before a human arms it
checkswhat this project has armed, the mode each host gives it, and whether it ever fired (#943)
listlist project rulings
showshow one ruling, including pending proposals

Ejemplos

daimon ruling propose --subject 'public posts' --verdict 'internal numbers never appear in public posts' --scope publishing --evidence issue:693 --by agent
daimon ruling ratify r-5b19c3

daimon ruling propose​

propose a standing ruling; agent proposals stay candidates until a human ratifies

daimon ruling propose --subject SUBJECT --verdict VERDICT --scope SCOPE --evidence SOURCE [--anchor ANCHOR] [--revisit-when REVISIT_WHEN] [--by agent] [--ratify] [--check-body-file PATH] [--check-match REGEX] [--check-intent enforce|record-only|warn] [--request-policy KEY=VALUE] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
--subjectSUBJECTwhat the ruling governs (obligatorio)
--verdictVERDICTthe ruling text itself (max 280 chars) (obligatorio)
--scopeSCOPEwhere it applies (obligatorio)
--evidenceSOURCEcited source behind the ruling; recorded verbatim, not resolved or verified; repeatable (obligatorio)
--anchorANCHORstable exact-match key such as issue:693; repeatable
--revisit-whenREVISIT_WHENcondition that makes reconsideration legitimate
--byagentdeclare yourself an agent; omit it only from an interactive terminal
--ratifyactivate immediately; valid only on the human path
--check-body-filePATHfile whose contents become the ruling's check script; the bytes are stored, the path is not (#943)
--check-matchREGEXregex on the command string that selects the actions the check runs before
--check-intentenforce|record-only|warnwhat the check asks each host for; the host delivers the strongest it supports (default warn)
--request-policyKEY=VALUEgrant this ruling authorizes, one of two shapes: sender=<slug> kind=work|info verb=accept by=agent (a sender this project trusts to record its own accept), or to=<slug> kind=info verb=open by=agent (this project's own agent may open an info ask there); repeatable, all four required per shape (#961)
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon ruling ratify​

activate a candidate ruling; prints the full text and confirms before the append

daimon ruling ratify ruling_id [--by agent] [--note NOTE] [--project PROJECT] [--slug SLUG] [--json]
argumentovalorpor defectodescripción
ruling_idexact r-… id
--byagentdeclare yourself an agent; ratification then refuses
--noteNOTEoptional ratification rationale
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)
--jsonmachine-readable output

daimon ruling revise​

revise a ruling; on an active ruling an agent call records a proposal and the text stands

daimon ruling revise ruling_id [--subject SUBJECT] [--verdict VERDICT] [--scope SCOPE] [--anchor ANCHOR] [--revisit-when REVISIT_WHEN] --evidence SOURCE [--by agent] [--ratify] [--check-body-file PATH] [--check-match REGEX] [--check-intent enforce|record-only|warn] [--request-policy KEY=VALUE] [--no-request-policy] [--project PROJECT] [--json]
argumentovalorpor defectodescripción
ruling_idexact r-… id
--subjectSUBJECTreplacement subject
--verdictVERDICTreplacement ruling text
--scopeSCOPEreplacement scope
--anchorANCHORreplacement anchor set; repeatable
--revisit-whenREVISIT_WHENreplacement revisit condition
--evidenceSOURCEsource cited for the revision; recorded, not verified; repeatable (obligatorio)
--byagentdeclare yourself an agent; on an active ruling the call then records a proposal and the text stands
--ratifyrefused: activation goes through daimon ruling ratify, which shows the text before the write
--check-body-filePATHfile whose contents become the ruling's check script; the bytes are stored, the path is not (#943)
--check-matchREGEXregex on the command string that selects the actions the check runs before
--check-intentenforce|record-only|warnwhat the check asks each host for; the host delivers the strongest it supports (default warn)
--request-policyKEY=VALUEreplacement grant, one of two shapes: sender=<slug> kind=work|info verb=accept by=agent (a sender this project trusts to record its own accept), or to=<slug> kind=info verb=open by=agent (this project's own agent may open an info ask there); repeatable, all four required per shape (#961)
--no-request-policyclear this ruling's request_policy; mutually exclusive with --request-policy
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon ruling retire​

end a ruling: a candidate as rejected, an active one as retired; agent calls propose, humans retire directly; evidence optional

daimon ruling retire ruling_id [--evidence SOURCE] [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG] [--json]
argumentovalorpor defectodescripción
ruling_idexact r-… id
--evidenceSOURCEoptional source for why the ruling stopped applying; repeatable
--noteNOTEoptional explanation
--byagentdeclare yourself an agent; the call then records a retirement proposal and the ruling stands until a human verdict
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)
--jsonmachine-readable output

daimon ruling check​

the check a ruling carries (#943): try it before a human arms it

daimon ruling check <command>
comandoqué hace
tryrun this ruling's check against a command and print the outcome; arms nothing, logs nothing

daimon ruling check try​

run this ruling's check against a command and print the outcome; arms nothing, logs nothing

daimon ruling check try ruling_id --command CMD [--cwd DIR] [--proposed] [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
ruling_idexact r-... id
--commandCMDthe command string to check, as a host would hand it to the hook (obligatorio)
--cwdDIRworking directory the command would run in; relative file arguments resolve against it (default: the current directory)
--proposedrun the pending revision's check instead of the armed one
--byagentdeclare yourself an agent; a dry run then refuses, because it executes the body
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon ruling checks​

what this project has armed, the mode each host gives it, and whether it ever fired (#943)

daimon ruling checks [--project PROJECT] [--json]
argumentovalorpor defectodescripción
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon ruling list​

list project rulings

daimon ruling list [--state active|candidate|overturned] [--project PROJECT] [--json] [--inherited]
argumentovalorpor defectodescripción
--stateactive|candidate|overturnedfilter by state; repeatable
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output
--inheritedalso list active rulings inherited from a ruling layer above this project (#1092); each row (each --json row too) carries inherited_from; refused on a tenant-scoped home, the same as every caller-chosen cross-project scope (#899)

daimon ruling show​

show one ruling, including pending proposals

daimon ruling show ruling_id [--project PROJECT] [--json]
argumentovalorpor defectodescripción
ruling_idexact r-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon amend​

record an evidence-carrying state transition on a briefed item (#691)

daimon amend <command>
comandoqué hace
proposepropose an amendment; agent proposals stay candidates until the session-end byte-check or a human verdict
ratifyactivate a candidate or verified amendment as a human decision
rejectreject an amendment with a reason, as a human decision
listlist project amendments, candidates first

Ejemplos

daimon amend o-3f8a2c --change progressed --evidence 'the PR merged' --by agent
daimon amend ratify a-7d41e0

daimon amend propose​

propose an amendment; agent proposals stay candidates until the session-end byte-check or a human verdict

daimon amend propose item_id --change blocked|changed|progressed --evidence EVIDENCE [--note NOTE] [--by agent] [--project PROJECT]
argumentovalorpor defectodescripción
item_idexact item id from a briefing/loops handle
--changeblocked|changed|progressedthe typed transition; the closed vocabulary is the render bound (obligatorio)
--evidenceEVIDENCEverbatim transcript quote backing the change; byte-checked against this session's transcript at session end (obligatorio)
--noteNOTEshort context; human channel only
--byagentdeclare yourself an agent; omit it only from an interactive terminal, which is the human path
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon amend ratify​

activate a candidate or verified amendment as a human decision

daimon amend ratify amendment_id ... [--by agent] [--project PROJECT] [--slug SLUG]
argumentovalorpor defectodescripción
amendment_idone or more exact a-… ids; all-or-nothing if any is unknown or in the wrong state
--byagentdeclare yourself an agent; ratification then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon amend reject​

reject an amendment with a reason, as a human decision

daimon amend reject amendment_id ... [--note NOTE] [--by agent] [--project PROJECT] [--slug SLUG]
argumentovalorpor defectodescripción
amendment_idone or more exact a-… ids; all-or-nothing if any is unknown
--noteNOTEwhy it is wrong; kept on the record
--byagentdeclare yourself an agent; rejection then refuses, because it requires a human channel
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGroute to another project's bucket by its slug, written --slug=<slug> (a slug starts with '-'); routing only, the channel gate is unchanged (#766)

daimon amend list​

list project amendments, candidates first

daimon amend list [--project PROJECT] [--json]
argumentovalorpor defectodescripción
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output