@nio-cli/cli 0.1.0

package/dist/lib/skill-serve.js

@@ -0,0 +1,129 @@
+import { readSkillFiles, toSkillDocs } from './skills.js';
+import { brand } from '../brand.js';
+/**
+ * Camada de **serviço** do pacote de skills pro servidor MCP: expõe os docs como
+ * resources (leitura sob demanda) e como prompts (slash/commands no Cowork e Codex).
+ * Só o `mcp-server.ts` importa isto — o CLI nunca precisa.
+ */
+export const SKILLS_URI_PREFIX = `${brand.name}://skills/`;
+let cache = null;
+/** Carrega o pacote de skills, memoizado (não muda enquanto o processo roda). */
+export function loadSkills(dir) {
+    if (cache && !dir)
+        return cache;
+    const files = readSkillFiles(dir);
+    const loaded = {
+        docs: toSkillDocs(files),
+        rawByPath: new Map(files.map((f) => [f.path, f.raw])),
+    };
+    if (!dir)
+        cache = loaded;
+    return loaded;
+}
+/** Limpa o cache (testes / dir custom). */
+export function clearSkillsCache() {
+    cache = null;
+}
+/**
+ * Nome do resource em estilo caminho — agrupa a listagem por tipo/skill (como o
+ * conector do Figma), em vez de despejar títulos soltos. Skills e commands viram
+ * `skill/<id>` / `command/<id>`; arquivos de apoio (templates, *-PATTERN) aninham
+ * sob a skill dona (`skill/init-sdd/templates/spec`); docs soltos viram `doc/<path>`.
+ */
+function resourceName(doc, skillFolders) {
+    if (doc.type === 'command')
+        return `command/${doc.id}`;
+    if (doc.type === 'agent')
+        return `agent/${doc.id}`;
+    if (doc.type === 'dependency')
+        return `dependency/${doc.id}`;
+    if (doc.type === 'skill')
+        return `skill/${doc.id}`;
+    // doc: aninha sob a skill dona, se estiver dentro da pasta de uma.
+    for (const [folder, id] of skillFolders) {
+        if (doc.path.startsWith(`${folder}/`)) {
+            const sub = doc.path.slice(folder.length + 1).replace(/\.md$/i, '');
+            return `skill/${id}/${sub}`;
+        }
+    }
+    return `doc/${doc.path.replace(/\.md$/i, '')}`;
+}
+export function skillResourceDescriptors(docs) {
+    // Pasta (dir do SKILL.md) → id, pra aninhar os arquivos de apoio sob a skill.
+    const skillFolders = new Map();
+    for (const d of docs) {
+        if (d.type === 'skill')
+            skillFolders.set(d.path.slice(0, d.path.lastIndexOf('/')), d.id);
+    }
+    return docs
+        // `command`/`skill` já são servidos como **prompts** — não repetir como resource
+        // (senão o Cowork lista cada um duas vezes). Aqui ficam só os arquivos de apoio
+        // (templates/patterns), agents e dependencies.
+        .filter((d) => d.type !== 'command' && d.type !== 'skill')
+        .map((d) => ({
+        uri: `${SKILLS_URI_PREFIX}${d.path}`,
+        name: resourceName(d, skillFolders),
+        description: d.description || d.title,
+        mimeType: 'text/markdown',
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/** Lê um resource pela URI, a partir dos docs + os markdowns crus por path. */
+export function readSkillResource(uri, docs, rawByPath) {
+    if (!uri.startsWith(SKILLS_URI_PREFIX))
+        throw new Error(`URI fora do pacote de skills: ${uri}`);
+    const rel = uri.slice(SKILLS_URI_PREFIX.length);
+    const doc = docs.find((d) => d.path === rel);
+    if (!doc)
+        throw new Error(`Recurso não encontrado: ${uri}`);
+    return { uri, mimeType: 'text/markdown', text: rawByPath.get(rel) ?? doc.content };
+}
+/** Só `command` e `skill` viram prompts (docs/agents/dependencies não). */
+function isPromptable(type) {
+    return type === 'command' || type === 'skill';
+}
+export function skillPromptDescriptors(docs) {
+    return docs
+        .filter((d) => isPromptable(d.type))
+        .map((d) => ({
+        name: d.id,
+        description: `[${d.type}] ${d.description || d.title}`.slice(0, 200),
+        arguments: [
+            {
+                name: 'args',
+                description: d.frontmatter['argument-hint'] || 'Argumentos opcionais passados ao prompt.',
+                required: false,
+            },
+        ],
+    }));
+}
+/** Monta o texto de um prompt: corpo do doc com `$ARGUMENTS` substituído. */
+export function buildSkillPrompt(name, args, docs) {
+    const doc = docs.find((d) => d.id === name && isPromptable(d.type));
+    if (!doc)
+        throw new Error(`Prompt desconhecido: ${name}`);
+    let text = doc.content.split('$ARGUMENTS').join(args?.args ?? '');
+    // Cowork/Codex servem a skill como **prompt** — não têm o filesystem dela. Então os
+    // arquivos de apoio (`templates/*`, `*-PATTERN.md`, `STANDARDS.md`) que o corpo
+    // referencia por path relativo não existem lá. Inline-os pra a skill ficar
+    // auto-contida (no Claude Code isso não roda — lá os arquivos são nativos).
+    if (doc.type === 'skill') {
+        const folder = doc.path.slice(0, doc.path.lastIndexOf('/'));
+        const companions = docs
+            .filter((d) => d.type === 'doc' && d.path.startsWith(`${folder}/`))
+            .sort((a, b) => a.path.localeCompare(b.path));
+        if (companions.length > 0) {
+            const blocks = companions
+                .map((comp) => {
+                const rel = comp.path.slice(folder.length + 1);
+                return `\n\n---\n\n### Arquivo de apoio da skill: \`${rel}\`\n\n${comp.content.trim()}`;
+            })
+                .join('');
+            text +=
+                `\n\n<!-- Arquivos de apoio inline: o Cowork/Codex não têm o filesystem da ` +
+                    `skill; use estes no lugar das referências por path relativo acima. -->${blocks}`;
+        }
+    }
+    return { description: doc.description || doc.title, text };
+}
+//# sourceMappingURL=skill-serve.js.map

package/dist/lib/skill-serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-serve.js","sourceRoot":"","sources":["../../src/lib/skill-serve.ts"],"names":[],"mappings":"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"}

package/dist/lib/skills-cache.js

@@ -0,0 +1,99 @@
+import { existsSync, mkdirSync, rmSync, cpSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import AdmZip from 'adm-zip';
+import { brand, env, homePath } from '../brand.js';
+/**
+ * Skills como repo aberto (não pacote npm): o CLI baixa o zipball do GitHub pro
+ * cache local (`~/.nio/skills`) e lê de lá — `skillsDir()` resolve pra cá sem
+ * checkout, e `nio sync` atualiza o cache sem republicar o CLI.
+ */
+const DEFAULT_REPO = brand.skillsRepo;
+const DEFAULT_REF = brand.skillsRef;
+/** `owner/repo` do repo de skills. Sobrescrevível via `NIO_SKILLS_REPO`. */
+export function skillsRepo() {
+    return env('SKILLS_REPO') || DEFAULT_REPO;
+}
+/** Branch/tag a baixar. Sobrescrevível via `NIO_SKILLS_REF`. */
+export function skillsRef() {
+    return env('SKILLS_REF') || DEFAULT_REF;
+}
+/** Raiz do cache local (o conteúdo do repo: `commands/`, `skills/`, `hooks/`, …). */
+export function skillsCacheDir() {
+    return homePath('skills');
+}
+const MARKER = `${brand.homeDirName}-skills.json`;
+/** Metadados do último fetch (repo/ref/quando). `null` se o cache não existe. */
+export function cacheMeta() {
+    const p = join(skillsCacheDir(), MARKER);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** O cache existe e parece válido (tem ao menos `skills/` ou `commands/`)? */
+export function skillsCached() {
+    const dir = skillsCacheDir();
+    return existsSync(join(dir, 'skills')) || existsSync(join(dir, 'commands'));
+}
+/**
+ * Baixa o repo de skills (zipball do GitHub) pro cache local. Sem `git` — usa
+ * `fetch` (Node 20+) + `adm-zip`. Idempotente: com `force=false` e cache presente,
+ * não toca a rede. Se o download falhar mas houver cache antigo, segue com ele.
+ */
+/** Timeout do download — sem isto o `fetch` pode pendurar no connect pra sempre. */
+const DEFAULT_TIMEOUT_MS = 20_000;
+export async function fetchSkills(opts = {}) {
+    const dir = skillsCacheDir();
+    const repo = skillsRepo();
+    const ref = skillsRef();
+    if (!opts.force && skillsCached()) {
+        return { status: 'cached', dir, repo, ref };
+    }
+    const url = `https://codeload.github.com/${repo}/zip/refs/heads/${ref}`;
+    const staging = join(tmpdir(), `${brand.name}-skills-${process.pid}-${Date.now()}`);
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { signal: ac.signal });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status} ao baixar ${url}`);
+        const buf = Buffer.from(await res.arrayBuffer());
+        // O zipball tem um único dir raiz (`<repo>-<ref>/`); extrai e mira nele.
+        rmSync(staging, { recursive: true, force: true });
+        mkdirSync(staging, { recursive: true });
+        new AdmZip(buf).extractAllTo(staging, true);
+        const dirs = readdirSync(staging, { withFileTypes: true }).filter((e) => e.isDirectory());
+        const root = dirs.length === 1 ? join(staging, dirs[0].name) : staging;
+        // Substitui o cache pelo conteúdo baixado.
+        rmSync(dir, { recursive: true, force: true });
+        mkdirSync(dir, { recursive: true });
+        cpSync(root, dir, { recursive: true });
+        const meta = { repo, ref, fetchedAt: new Date().toISOString() };
+        writeFileSync(join(dir, MARKER), JSON.stringify(meta, null, 2) + '\n', 'utf8');
+        return { status: 'fetched', dir, repo, ref };
+    }
+    catch (err) {
+        const msg = ac.signal.aborted
+            ? `timeout após ${timeoutMs}ms baixando ${url}`
+            : err.message;
+        if (skillsCached()) {
+            return { status: 'cached', dir, repo, ref, error: msg };
+        }
+        return { status: 'failed', dir, repo, ref, error: msg };
+    }
+    finally {
+        clearTimeout(timer);
+        rmSync(staging, { recursive: true, force: true });
+    }
+}
+/** Garante que o cache exista (baixa só se ausente). Best-effort pro runtime do MCP. */
+export async function ensureSkillsCache() {
+    return fetchSkills({ force: false });
+}
+//# sourceMappingURL=skills-cache.js.map

package/dist/lib/skills-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-cache.js","sourceRoot":"","sources":["../../src/lib/skills-cache.ts"],"names":[],"mappings":"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"}

package/dist/lib/skills.js

@@ -0,0 +1,236 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join, relative, sep, dirname } from 'node:path';
+import { skillsCacheDir, skillsCached } from './skills-cache.js';
+import { includePath } from './sections.js';
+import { brand, env } from '../brand.js';
+/**
+ * Diretório do conteúdo das skills. Resolve em ordem: `NIO_SKILLS_DIR`
+ * (checkout local), `@nio-cli/skills` via require.resolve (dev legado), ou o
+ * cache `~/.nio/skills` populado por `nio sync`/`init` (fluxo padrão).
+ */
+export function skillsDir() {
+    const override = env('SKILLS_DIR');
+    if (override && existsSync(override))
+        return override;
+    try {
+        const require = createRequire(import.meta.url);
+        return dirname(require.resolve(`${brand.skillsPackage}/package.json`));
+    }
+    catch {
+        /* pacote ausente (modelo repo-aberto) → cai pro cache local */
+    }
+    if (skillsCached())
+        return skillsCacheDir();
+    throw new Error(`Conteúdo de skills não encontrado. Rode \`${brand.name} sync\` pra baixar o repo ` +
+        '(ou defina NIO_SKILLS_DIR apontando pra um checkout local).');
+}
+function listMarkdown(dir) {
+    const out = [];
+    const walk = (abs) => {
+        for (const entry of readdirSync(abs, { withFileTypes: true })) {
+            if (entry.name.startsWith('.'))
+                continue;
+            const childAbs = join(abs, entry.name);
+            if (entry.isDirectory())
+                walk(childAbs);
+            else if (entry.isFile() &&
+                entry.name.toLowerCase().endsWith('.md') &&
+                entry.name.toLowerCase() !== 'readme.md')
+                out.push(relative(dir, childAbs).split(sep).join('/'));
+        }
+    };
+    walk(dir);
+    return out;
+}
+/**
+ * Coleta as linhas indentadas/vazias seguintes (bloco YAML folded `>` ou literal `|`)
+ * a partir de `lines[i + 1]`. Retorna o valor já juntado e o novo índice do cursor
+ * (última linha consumida) pro chamador continuar o loop dali.
+ */
+function collectBlockValue(lines, i, folded) {
+    const collected = [];
+    while (i + 1 < lines.length && (lines[i + 1].trim() === '' || /^\s+\S/.test(lines[i + 1]))) {
+        collected.push(lines[++i].trim());
+    }
+    const value = folded
+        ? collected.join(' ').replace(/\s+/g, ' ').trim()
+        : collected.join('\n').trim();
+    return { value, nextIndex: i };
+}
+/** Valor entre aspas simples/duplas → sem as aspas. Sem aspas → devolve como veio. */
+function unquote(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+/**
+ * Parser de frontmatter minimalista: `key: value` de uma linha, mais blocos
+ * folded (`>`) e literal (`|`). Suficiente pros metadados (não é YAML completo).
+ */
+function parseFrontmatter(raw) {
+    const fm = {};
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(raw);
+    if (!match)
+        return { frontmatter: fm, body: raw };
+    const lines = match[1].split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const m = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(lines[i]);
+        if (!m)
+            continue;
+        const key = m[1];
+        const value = m[2].trim();
+        if (/^[|>][+-]?$/.test(value)) {
+            const block = collectBlockValue(lines, i, value[0] === '>');
+            fm[key] = block.value;
+            i = block.nextIndex;
+            continue;
+        }
+        fm[key] = unquote(value);
+    }
+    return { frontmatter: fm, body: raw.slice(match[0].length) };
+}
+/** Clientes de IA reconhecidos pra visibilidade de docs. */
+export const KNOWN_CLIENTS = ['claude-code', 'codex', 'cowork'];
+const KNOWN_CLIENTS_SET = new Set(KNOWN_CLIENTS);
+/**
+ * Parseia o campo `clients:` do frontmatter (lista separada por vírgula/espaço)
+ * num conjunto normalizado. Vazio/ausente/sem valor válido → `null` (= todos).
+ */
+export function parseClients(value) {
+    if (!value)
+        return null;
+    const list = value
+        .split(/[,\s]+/)
+        .map((s) => s.trim().toLowerCase())
+        .filter((s) => KNOWN_CLIENTS_SET.has(s));
+    return list.length > 0 ? [...new Set(list)] : null;
+}
+/** Um doc é visível pra um surface se não restringe clientes ou inclui aquele. */
+export function docForSurface(doc, surface) {
+    if (!surface)
+        return true;
+    return !doc.clients || doc.clients.includes(surface);
+}
+/** Recorta a lista de docs pros visíveis num surface. */
+export function filterSkillsForSurface(docs, surface) {
+    if (!surface)
+        return docs;
+    return docs.filter((d) => docForSurface(d, surface));
+}
+/**
+ * Filtra docs crus (relPath+conteúdo) pros visíveis num surface. Docs sem
+ * frontmatter de doc (ex.: scripts soltos) são mantidos por padrão.
+ */
+export function filterDocsForSurface(docs, surface) {
+    if (!surface)
+        return docs;
+    const parsed = toSkillDocs(docs.map((d) => ({ path: d.relPath, raw: d.content.toString('utf8') })));
+    const hidden = new Set(parsed.filter((n) => !docForSurface(n, surface)).map((n) => n.path));
+    return docs.filter((d) => !hidden.has(d.relPath));
+}
+function typeForPath(relPath) {
+    const parts = relPath.split('/');
+    const top = parts[0];
+    const base = parts[parts.length - 1].toLowerCase();
+    if (top === 'commands')
+        return 'command';
+    // Só `SKILL.md` é a skill; arquivos de apoio (STANDARDS.md, etc.) são `doc`.
+    if (top === 'skills')
+        return base === 'skill.md' ? 'skill' : 'doc';
+    if (top === 'agents')
+        return 'agent';
+    if (top === 'dependencies')
+        return 'dependency';
+    return 'doc';
+}
+/** Id de invocação: skill = nome da pasta (SKILL.md); o resto = basename sem `.md`. */
+function idForPath(relPath) {
+    const parts = relPath.split('/');
+    const base = parts[parts.length - 1];
+    if (base.toLowerCase() === 'skill.md' && parts.length >= 2)
+        return parts[parts.length - 2];
+    return base.replace(/\.md$/i, '');
+}
+function humanize(id) {
+    return id.replace(/[-_]/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/**
+ * "Kinds" do pacote que viram docs. `rules/`, `hooks/`, `index.md`, `README.md`,
+ * `scripts/` etc. são deliberadamente ignorados — o CLI não lida com eles aqui.
+ */
+const SKILL_KINDS = ['commands', 'skills', 'agents', 'dependencies'];
+/** Lê os `.md` dos kinds do pacote (`@nio-cli/skills`) como RawDoc[]. */
+export function readSkillFiles(dir = skillsDir()) {
+    if (!existsSync(dir)) {
+        throw new Error(`Pacote de skills não encontrado em ${dir}. Instale/publique ${brand.skillsPackage}.`);
+    }
+    const docs = [];
+    for (const kind of SKILL_KINDS) {
+        const kindDir = join(dir, kind);
+        if (!existsSync(kindDir))
+            continue;
+        for (const rel of listMarkdown(kindDir)) {
+            docs.push({ path: `${kind}/${rel}`, raw: readFileSync(join(kindDir, rel), 'utf-8') });
+        }
+    }
+    return docs;
+}
+/** Constrói os docs a partir de arquivos crus (frontmatter + corpo). */
+export function toSkillDocs(files) {
+    return files
+        .map(({ path: relPath, raw }) => {
+        const { frontmatter, body } = parseFrontmatter(raw);
+        const id = idForPath(relPath);
+        return {
+            id,
+            uid: frontmatter.id ? String(frontmatter.id).trim() : null,
+            title: frontmatter.title || frontmatter.name || humanize(id),
+            type: typeForPath(relPath),
+            path: relPath,
+            description: frontmatter.description ?? '',
+            frontmatter,
+            content: body.trim(),
+            clients: parseClients(frontmatter.clients),
+        };
+    })
+        .sort((a, b) => a.path.localeCompare(b.path));
+}
+export function readSkillDocs(dir = skillsDir()) {
+    return toSkillDocs(readSkillFiles(dir));
+}
+/**
+ * Docs `dependency` do pacote — libs externas que a CLI oferece instalar no fim do
+ * `sync`/`init`. Escopadas pela **seleção** (role/área/stack, `general` em cascata):
+ * `dev/general` sempre, mais as da área/stack escolhidos. Sem seleção → todas.
+ * Best-effort: `[]` se o pacote não estiver disponível.
+ */
+export function readDependencies(selection, dir = skillsDir()) {
+    try {
+        let deps = readSkillDocs(dir).filter((d) => d.type === 'dependency');
+        if (selection)
+            deps = deps.filter((d) => includePath(d.path, selection));
+        return deps.sort((a, b) => a.title.localeCompare(b.title));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Mapa `nome de invocação → id sequencial (frontmatter)`, pra telemetria estável.
+ * Best-effort: mapa vazio se o `@nio-cli/skills` não estiver disponível.
+ */
+export function skillIdMap(dir = skillsDir()) {
+    const map = new Map();
+    try {
+        for (const d of readSkillDocs(dir))
+            map.set(d.id, d.uid);
+    }
+    catch {
+        /* @nio-cli/skills ausente → telemetria sem ids */
+    }
+    return map;
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"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"}

package/dist/lib/targets.js

@@ -0,0 +1,151 @@
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { toSkillDocs } from './skills.js';
+import { readJson, readToml } from './file-merge.js';
+import { brand } from '../brand.js';
+export const claudeTarget = {
+    id: 'claude',
+    label: 'Claude Code (~/.claude)',
+    surface: 'claude-code',
+    targetDir: () => join(homedir(), '.claude'),
+    mapDocs: (docs) => docs,
+};
+/**
+ * Texto que substitui `$ARGUMENTS` na tradução pro Codex. Skills do Codex são
+ * selecionadas por descrição e dirigidas por linguagem natural — não há
+ * substituição de slash-args como no caminho de command/prompt do Claude.
+ */
+const ARGS_REWORD = 'the arguments the user provided';
+/** Escapa uma descrição pra uma linha de YAML entre aspas duplas. */
+function yamlQuote(value) {
+    const oneLine = value.replace(/\r?\n/g, ' ').replace(/\s+/g, ' ').trim();
+    return `"${oneLine.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/** Renderiza o SKILL.md de um node no formato Agent Skills (name + description). */
+export function toCodexSkillContent(node) {
+    const description = node.frontmatter.description || node.description || node.title;
+    const frontmatter = `---\nname: ${node.id}\ndescription: ${yamlQuote(description)}\n---\n`;
+    let body = node.content;
+    if (body.includes('$ARGUMENTS')) {
+        body = body.split('$ARGUMENTS').join(ARGS_REWORD);
+    }
+    // `argument-hint` não existe em skills — dobra num aviso de entrada esperada.
+    const hint = node.frontmatter['argument-hint'];
+    const inputLine = hint ? `**Expected input:** ${hint}\n\n` : '';
+    return `${frontmatter}\n${inputLine}${body.trim()}\n`;
+}
+/**
+ * Renderiza um custom prompt do Codex (`~/.codex/prompts/<id>.md`). Diferente da skill,
+ * o Codex expande `$ARGUMENTS`/`$1..$9` aqui, então preservamos os placeholders.
+ */
+export function toCodexPromptContent(node) {
+    const description = node.frontmatter.description || node.description || node.title;
+    const hint = node.frontmatter['argument-hint'];
+    const fmLines = [`description: ${yamlQuote(description)}`];
+    if (hint)
+        fmLines.push(`argument-hint: ${yamlQuote(hint)}`);
+    const frontmatter = `---\n${fmLines.join('\n')}\n---\n`;
+    // Corpo original, com `$ARGUMENTS`/`$1` intactos (o Codex substitui na invocação).
+    return `${frontmatter}\n${node.content.trim()}\n`;
+}
+/**
+ * Traduz os docs crus pro layout do Codex em dual-write: cada `command`/`skill` vira
+ * uma skill (`skills/<id>/SKILL.md`) E um custom prompt (`prompts/<id>.md`). Os
+ * arquivos de apoio de uma skill (`templates/*.md`, `*-PATTERN.md`, `STANDARDS.md` —
+ * type `doc`, vizinhos do `SKILL.md`) são carregados pra dentro de `skills/<id>/`
+ * preservando o path relativo, pra que o SKILL.md traduzido consiga referenciá-los
+ * exatamente como no Claude. `agent` e `doc` fora de uma skill são ignorados.
+ */
+export function toCodexDocs(docs) {
+    const nodes = toSkillDocs(docs.map((d) => ({ path: d.relPath, raw: d.content.toString('utf8') })));
+    const rawByPath = new Map(docs.map((d) => [d.relPath, d.content]));
+    // Pasta da skill (dir do SKILL.md) -> id, pra rotear os arquivos de apoio.
+    const skillFolders = new Map();
+    for (const node of nodes) {
+        if (node.type === 'skill') {
+            skillFolders.set(node.path.slice(0, node.path.lastIndexOf('/')), node.id);
+        }
+    }
+    const out = [];
+    const seen = new Map(); // id -> path de origem (guarda de colisão)
+    for (const node of nodes) {
+        if (node.type === 'command' || node.type === 'skill') {
+            const prev = seen.get(node.id);
+            if (prev) {
+                throw new Error(`Tradução Codex: id duplicado "${node.id}" (${prev} e ${node.path}). ` +
+                    `O id precisa ser único — renomeie um deles.`);
+            }
+            seen.set(node.id, node.path);
+            out.push({
+                relPath: `skills/${node.id}/SKILL.md`,
+                content: Buffer.from(toCodexSkillContent(node), 'utf8'),
+            });
+            out.push({
+                relPath: `prompts/${node.id}.md`,
+                content: Buffer.from(toCodexPromptContent(node), 'utf8'),
+            });
+            continue;
+        }
+        // Arquivo de apoio de uma skill: carrega verbatim pro dir da skill traduzida,
+        // mantendo o path relativo (ex.: `templates/spec.md`, `SPEC-PATTERN.md`).
+        if (node.type === 'doc') {
+            for (const [folder, id] of skillFolders) {
+                if (!node.path.startsWith(`${folder}/`))
+                    continue;
+                const rel = node.path.slice(folder.length + 1);
+                const raw = rawByPath.get(node.path);
+                if (raw)
+                    out.push({ relPath: `skills/${id}/${rel}`, content: raw });
+                break;
+            }
+        }
+    }
+    return out;
+}
+export const codexTarget = {
+    id: 'codex',
+    label: 'Codex CLI (~/.codex)',
+    surface: 'codex',
+    targetDir: () => join(homedir(), '.codex'),
+    mapDocs: (docs) => toCodexDocs(docs),
+};
+export const ALL_TARGETS = [claudeTarget, codexTarget];
+function claudeConfigured() {
+    const path = join(homedir(), '.claude', 'settings.json');
+    if (!existsSync(path))
+        return false;
+    try {
+        const json = (readJson(path) ?? {});
+        return Boolean(json.mcpServers?.[brand.mcpServerKey]);
+    }
+    catch {
+        return false;
+    }
+}
+function codexConfigured() {
+    const path = join(homedir(), '.codex', 'config.toml');
+    if (!existsSync(path))
+        return false;
+    try {
+        const toml = (readToml(path) ?? {});
+        return Boolean(toml.mcp_servers?.[brand.mcpServerKey]);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Alvos que já têm o servidor `nio` configurado (~/.claude/settings.json,
+ * ~/.codex/config.toml). Base do auto-detect de `sync`: provisiona pra cada
+ * cliente que o worker de fato usa, sem flags.
+ */
+export function detectConfiguredTargets() {
+    const targets = [];
+    if (claudeConfigured())
+        targets.push(claudeTarget);
+    if (codexConfigured())
+        targets.push(codexTarget);
+    return targets;
+}
+//# sourceMappingURL=targets.js.map