dd-harness 0.39.0 → 0.40.0

package/dist/atualizar.d.ts

@@ -21,6 +21,8 @@ export type Item = {
  * maquina, nao por projeto).
  */
 export declare function diagnosticaAtualizacao(raiz: string, versaoInstalada: string, versaoPublicada: string | null): Promise<Item[]>;
+/** Reescreve em disco os ponteiros das skills que o serviço tem. */
+export declare function reescrevePonteiros(raiz: string): Promise<string>;
 /**
  * Incorpora ao projeto as skills iniciais escolhidas pelo usuario.
  *

package/dist/atualizar.js

@@ -140,7 +140,7 @@ export async function diagnosticaAtualizacao(raiz, versaoInstalada, versaoPublic
     return itens;
 }
 /** Reescreve em disco os ponteiros das skills que o serviço tem. */
-async function reescrevePonteiros(raiz) {
+export async function reescrevePonteiros(raiz) {
     const destinos = [...new Set((await hostsInstalados(raiz))
             .map(h => h === "claude" ? ".claude" : ".agents"))];
     const r = await escrevePonteirosDeSkills(raiz, await leSkills(raiz), destinos.length ? destinos : [".claude"]);

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { diagnostico } from "./diagnostico.js";
-import { aplicaAtualizacao, diagnosticaAtualizacao, versaoInstalada, versaoPublicada } from "./atualizar.js";
+import { aplicaAtualizacao, diagnosticaAtualizacao, reescrevePonteiros, versaoInstalada, versaoPublicada } from "./atualizar.js";
 import { instalaHosts, selecionaHosts } from "./hosts.js";
 import { achaRaiz } from "./config.js";
 import { abreSessao, guardaSessao, saidaDaGuarda, saidaDoBoot } from "./sessao.js";
@@ -27,7 +27,7 @@ import { pergunta, escolha, fechaPerguntas } from "./pergunta.js";
 import { buscaPolitica } from "./politica.js";
 import { avisoDeOrdem, blocoDeSessao, criaFase, editaFase, formataChangelog, formataRoadmap, leFases, } from "./roadmap.js";
 import { decideDoHook, guardaCache } from "./cinto.js";
-import { escrevePonteirosDeSkills, leSkill, leSkills, semeiaSkills } from "./skill.js";
+import { criaSkill, editaSkill, escrevePonteirosDeSkills, leSkill, leSkills, semeiaSkills } from "./skill.js";
 import { SKILLS_INICIAIS } from "./skills-iniciais.js";
 import { busca } from "./buscar.js";
 import { apaga, arquiva, edita, le, promove } from "./curar.js";
@@ -80,7 +80,7 @@ const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
                                      projeto do espaço, inclusive os futuros
   dd-harness despromover <pasta>/<slug>
                                      traz de volta ao alcance dos vínculos
-  dd-harness apagar <pasta>/<slug> [--confirmar "<frase devolvida>"]
+  dd-harness apagar <pasta>/<slug> [--confirmar "<frase devolvida>"]
                                      apaga de vez, em cascata — sem desfazer.
                                      Para tirar de circulação guardando o
                                      conteúdo, use "arquivar"
@@ -101,6 +101,11 @@ const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
   dd-harness skills                 as skills deste projeto e quando cada uma serve
   dd-harness skill <nome>           o procedimento de uma delas (o mesmo que o
                                      agente recebe ao invocá-la)
+  dd-harness skill criar <nome> --descricao "<quando invocar>" [--conteudo <arquivo.md>]
+                     [--so-por-comando true|false]
+  dd-harness skill editar <nome> [--descricao "<d>"] [--conteudo <arquivo.md>]
+                     [--so-por-comando true|false]
+                                     grava no serviço e reescreve o ponteiro em disco
   dd-harness roadmap                as fases abertas: a atual inteira, as próximas
                                      por título (opcional — projeto sem fase não tem)
   dd-harness changelog [--versao <v>]
@@ -140,11 +145,9 @@ function argumento(argv, nome) {
 const API_PADRAO = "https://dd-harness.vercel.app";
 // --- roadmap e changelog ---
 /**
- * `skills` e `skill <slug>` — so LEITURA.
- *
- * Criar e editar ficam na interface de proposito: escrever procedimento e trabalho de
- * texto longo, e um editor de verdade e melhor que um flag de linha de comando. O que o
- * terminal precisa e ver o que existe e conferir um procedimento sem trocar de janela.
+ * `skills` e `skill <slug>` — leitura. Criar e editar sao `skill criar|editar`, com o
+ * procedimento vindo de um .md (`--conteudo`), como em `fase` e `gravar`: sem isso a skill
+ * `escrever-skill` redigia o texto e nao tinha como grava-lo fora da interface.
  */
 async function comandoSkills() {
     const skills = await leSkills(process.cwd());
@@ -160,10 +163,44 @@ async function comandoSkills() {
     }
     console.log(`${skills.length} skill(s). \`dd-harness skill <nome>\` mostra o procedimento.`);
 }
+/** `--so-por-comando true|false`: flag solta seria so "ligar", e desligar tambem e edicao. */
+function soPorComandoDoArgv(argv) {
+    const v = argumento(argv, "so-por-comando");
+    if (v === undefined)
+        return undefined;
+    if (v !== "true" && v !== "false")
+        throw new Error("--so-por-comando: use true ou false.");
+    return v === "true";
+}
+/**
+ * `skill criar` e `skill editar`. O ponteiro em disco e reescrito em seguida: descricao e
+ * "so por comando" moram no frontmatter dele, e o host so le o disco.
+ */
+async function comandoSkillEscrita(acao, argv) {
+    const [slug, ...opcoes] = argv;
+    if (!slug || slug.startsWith("--"))
+        throw new Error(`skill ${acao} exige o nome da skill.`);
+    const campos = {
+        descricao: argumento(opcoes, "descricao"),
+        conteudo: await conteudoDoArgv(opcoes),
+        so_por_comando: soPorComandoDoArgv(opcoes),
+    };
+    if (acao === "criar") {
+        if (!campos.descricao)
+            throw new Error('skill criar exige --descricao "<quando invocar>".');
+        await criaSkill(process.cwd(), { ...campos, slug, descricao: campos.descricao, conteudo: campos.conteudo ?? "" });
+    }
+    else {
+        await editaSkill(process.cwd(), slug, campos);
+    }
+    console.log(`Skill ${slug} ${acao === "criar" ? "criada" : "atualizada"}; ${await reescrevePonteiros(process.cwd())}.`);
+}
 async function comandoSkill(argv) {
     const slug = argv[0];
+    if (slug === "criar" || slug === "editar")
+        return comandoSkillEscrita(slug, argv.slice(1));
     if (!slug || slug.startsWith("-")) {
-        throw new Error("uso: dd-harness skill <nome>");
+        throw new Error("uso: dd-harness skill <nome>  |  dd-harness skill criar|editar <nome> [...]");
     }
     const s = await leSkill(process.cwd(), slug);
     console.log(`# ${s.slug}

package/dist/skill.d.ts

@@ -31,6 +31,11 @@ export declare function leSkill(raiz: string, slug: string): Promise<SkillComple
 export declare function criaSkill(raiz: string, dados: NovaSkillInicial & Partial<Pick<Skill, "so_por_comando" | "ferramentas" | "caminhos" | "dica_de_argumento">>): Promise<{
     skill: Skill;
 }>;
+/** Só o que muda: o que não vier fica como está no serviço. */
+export type EdicaoDeSkill = Partial<Pick<SkillCompleta, "descricao" | "conteudo" | "so_por_comando" | "ferramentas" | "caminhos" | "dica_de_argumento">>;
+export declare function editaSkill(raiz: string, slug: string, dados: EdicaoDeSkill): Promise<{
+    skill: Skill;
+}>;
 /**
  * O SKILL.md que vai para o disco: frontmatter de verdade, corpo que aponta para o MCP.
  *

package/dist/skill.js

@@ -38,6 +38,17 @@ dados) {
         await recusa(resposta);
     return (await jsonDaEscrita(resposta));
 }
+export async function editaSkill(raiz, slug, dados) {
+    const { config, token } = await credencial(raiz);
+    const resposta = await pede(`${config.api}/api/v1/skills/${encodeURIComponent(slug)}`, {
+        method: "PATCH",
+        headers: cabecalhos(token, true),
+        body: JSON.stringify({ tenant: config.tenant, projeto: config.projeto, ...dados }),
+    });
+    if (!resposta.ok)
+        await recusa(resposta);
+    return (await jsonDaEscrita(resposta));
+}
 // --- o ponteiro em disco (puro, para ser testado sem rede) ---
 /**
  * Escapa o que quebraria o YAML do frontmatter.