Comments

O Comments é o único registro de conversa da raiz: comentários em threads sobre um Blueprint (o plano), um documento de nível superior, uma página de canvas ou uma tarefa, resolvidos quando encerrados, assinados por quem os escreveu. Toda thread vive na área de trabalho do plugin, e o plugin projeta as threads de um arquivo em uma região no pé do seu corpo como markdown legível. O armazenamento é a verdade; a região é o que ele mostra. Ligado por padrão.

Uma thread aponta para o seu alvo por um id permanente, nunca por um caminho, e para um lugar dentro dele por conteúdo (o texto de um título, o texto de um item), nunca por número de linha. Uma edição acima dela não a move; quando o conteúdo para o qual apontava some, a thread é mostrada como órfã em vez de perseguida.

No navegador

• Na página, as threads ficam no pé do corpo em todo modo, no modal e na página completa. Um + em um título ou em um critério de aceitação começa uma thread ancorada ali; @alias completa a partir dos usuários da raiz; uma thread tem respostas, Resolve e um excluir ao passar o mouse.
• Comments, uma atividade na barra de atividades com a contagem de threads abertas: cada thread aberta por anfitrião com o rótulo da sua âncora e a última mensagem, abrindo o alvo na âncora. Mostrar resolvidas, mostrar órfãs, Remove all orphaned, e em uma thread órfã, reancorar, resolver ou excluir. Um anfitrião desligado deixa as suas threads listadas sob Elsewhere.
• Uma mensagem é assinada pelo usuário como quem esta máquina age (a partir do shell, vem primeiro o usuário que --as ou EIDOS_USER nomeiam); senão, pela identidade do git casada com um usuário listado através do plugin Git; senão, pelo nome do git com o papel do me.md. Atribuição, não autenticação.

Threads sobre uma página de canvas são desenhadas como pinos; threads sobre uma tarefa ficam no pé da tarefa. Cada um desses anfitriões diz o que é uma âncora. Canvas → · Backlog →

Em disco

• .eidos/plugins/comments/threads/<thread-id>.yaml: uma thread. id; target { host, id } (host é blueprint, doc ou o nome de um plugin); at, as chaves de âncora próprias do anfitrião (as de um Blueprint são section, o texto de um título, e item, o texto de um item), ausente em uma thread sobre o todo; resolved; messages[{ author, role?, user?, text, at }]. Um arquivo editado à mão é lido como está escrito.
• .eidos/plugins/comments/settings.yaml: delete_orphaned, partilhado, desligado por padrão; ligado, uma thread cujo alvo ou âncora sumiu é excluída na próxima leitura em vez de listada como órfã.
• Em cada arquivo comentado, a região entre <!-- comments:threads --> e <!-- /comments:threads --> no pé do corpo: toda thread, aberta e resolvida, como markdown. Ela é escrita com a primeira thread e removida com a última, então um arquivo que ninguém comentou não carrega região. Nunca digite dentro dela; a próxima reescrita a substitui por inteiro. Um comentário é um salvar do arquivo e aparece no histórico do git como tal.

A partir do shell

eidos comments                                   # every open thread, grouped by host
eidos comments @login                            # the threads on one blueprint; --resolved, --json
eidos comments add @login "Is the limit per user?" --section "Behaviors"
eidos comments add @login "Per user." --reply <thread>
eidos comments add @login "Checked." --reply <thread> --as plato   # assinado como um usuário da raiz
eidos users                                      # os usuários da raiz; --json
eidos users add "Plato" --alias plato --agent    # um usuário na hora: só o nome é preciso
eidos comments resolve @login <thread>           # --reopen
eidos comments delete @login <thread>
eidos comments project                           # rewrite every region that drifted; or one target

Um alvo é uma referência a um Blueprint (@<id>, um caminho, um nome de arquivo), um documento ou <host>:<id> (backlog:<task>, canvas:<page>). --section, --item e --at key=value ancoram uma thread dentro do seu alvo.

Um agente lê as threads de um alvo antes de editá-lo, responde a uma pergunta com add --reply e resolve só quando o dono diz que algo está encerrado. O comando assina a mensagem; um arquivo de thread nunca é editado para comentar.

Um agente comenta como si mesmo, nunca como a pessoa para quem trabalha. Sem --as, um comentário é assinado pelo usuário que age, que na cópia de alguém é essa pessoa. Por isso um agente consulta eidos users, adiciona-se uma vez com eidos users add "<Seu nome>" --alias <alias> --agent quando não está lá (nenhum papel é preciso), e passa --as <alias> em cada comments add. Um nome que não é de nenhum usuário é recusado com o eidos users add que o cria. O Plato inicia seu agente assinando como o usuário como quem age, por padrão um usuário Plato que ele adiciona aos usuários da raiz; com Plato como usuário desligado nas configurações do Plato, seu agente não comenta como ninguém e cada comentário que tenta é recusado. Na página de configurações Users, o interruptor Agente de uma linha marca um usuário como agente.

O que a verificação relata

comments/anchor-missing (uma thread cujo anfitrião diz que o seu alvo ou âncora não resolve mais) e comments/region-stale (um arquivo cuja região não é o que o armazenamento escreveria, incluindo uma deixada para trás depois que a sua última thread foi excluída). Project corrige a segunda.