@nio-cli/cli 0.1.0

package/dist/lib/provision-apply.js

@@ -0,0 +1,220 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync, lstatSync, readlinkSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { VERSION } from "../version.js";
+import { brand } from "../brand.js";
+/**
+ * Motor do provisionamento: hash/manifesto (`.<marca>-provision.json`), escrita
+ * idempotente e poda do que o nio gravou. `provision.ts` monta a lista e chama
+ * `applyProvision`; `uninstallProvision` desfaz pelo mesmo manifesto.
+ */
+export const MANIFEST_NAME = `.${brand.name}-provision.json`;
+export function defaultTargetDir() {
+    return join(homedir(), ".claude");
+}
+function sha256(buf) {
+    return createHash("sha256").update(buf).digest("hex");
+}
+function readManifest(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        if (parsed && typeof parsed === "object" && parsed.files)
+            return parsed;
+    }
+    catch {
+        // manifesto corrompido → trata como ausente e reconstrói
+    }
+    return null;
+}
+/**
+ * Se um componente de `dir` é symlink com alvo inexistente (dotfiles gerenciando
+ * `~/.claude`), materializa o alvo em vez de deixar o `mkdir -p` estourar ENOENT.
+ * Retorna `true` se materializou algo. Escrever depois grava através do link.
+ */
+function materializeDanglingLink(dir) {
+    let cursor = dir;
+    for (;;) {
+        let info;
+        try {
+            info = lstatSync(cursor);
+        }
+        catch {
+            // cursor não existe (parent pendurado) → sobe um nível.
+            const parent = dirname(cursor);
+            if (parent === cursor)
+                return false;
+            cursor = parent;
+            continue;
+        }
+        if (info.isSymbolicLink()) {
+            const target = resolve(dirname(cursor), readlinkSync(cursor));
+            if (existsSync(target))
+                return false; // link ok — o ENOENT veio de outro lugar
+            mkdirSync(target, { recursive: true });
+            return true;
+        }
+        return false; // cursor existe e é real → não há link pendurado acima
+    }
+}
+/** `mkdir -p` tolerante a symlinks pendurados de dotfiles (ver acima). */
+export function ensureDir(dir) {
+    for (let attempt = 0; attempt < 40; attempt++) {
+        try {
+            mkdirSync(dir, { recursive: true });
+            return;
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            if (!materializeDanglingLink(dir))
+                throw err;
+        }
+    }
+    mkdirSync(dir, { recursive: true });
+}
+function writeFile(targetAbs, content) {
+    ensureDir(dirname(targetAbs));
+    writeFileSync(targetAbs, content);
+}
+/**
+ * Núcleo do provisionamento: aplica `docs` no destino, idempotente e não-destrutivo
+ * via manifesto. Retorna o plano por arquivo.
+ */
+export function applyProvision(docs, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const force = options.force ?? false;
+    const prune = options.prune ?? true;
+    const targetDir = options.targetDir ?? defaultTargetDir();
+    const manifestPath = join(targetDir, MANIFEST_NAME);
+    const oldFiles = readManifest(manifestPath)?.files ?? {};
+    const files = docs.map((d) => ({
+        relPath: d.relPath,
+        content: d.content,
+        hash: sha256(d.content),
+    }));
+    const incomingSet = new Set(files.map((f) => f.relPath));
+    const results = [];
+    const newFiles = {};
+    for (const f of files) {
+        const targetAbs = join(targetDir, f.relPath);
+        // Um arquivo problemático (ex.: symlink de dotfiles quebrado) vira um resultado
+        // `write-error` e a sincronização segue — nunca aborta o resto por causa de um.
+        try {
+            if (!existsSync(targetAbs)) {
+                if (!dryRun)
+                    writeFile(targetAbs, f.content);
+                results.push({ relPath: f.relPath, action: "create" });
+                newFiles[f.relPath] = f.hash;
+                continue;
+            }
+            const existingHash = sha256(readFileSync(targetAbs));
+            if (existingHash === f.hash) {
+                results.push({ relPath: f.relPath, action: "unchanged" });
+                newFiles[f.relPath] = f.hash;
+                continue;
+            }
+            // Divergente. Só atualizamos se o arquivo era nosso e o worker não mexeu,
+            // ou se ele pediu --force.
+            const wasOursUntouched = oldFiles[f.relPath] === existingHash;
+            if (wasOursUntouched || force) {
+                if (!dryRun)
+                    writeFile(targetAbs, f.content);
+                results.push({
+                    relPath: f.relPath,
+                    action: "update",
+                    detail: wasOursUntouched
+                        ? undefined
+                        : "forçado sobre arquivo divergente",
+                });
+                newFiles[f.relPath] = f.hash;
+            }
+            else {
+                results.push({
+                    relPath: f.relPath,
+                    action: "skip-conflict",
+                    detail: oldFiles[f.relPath] !== undefined
+                        ? "editado localmente"
+                        : "arquivo de terceiros",
+                });
+                // Não reivindica propriedade: fica de fora do novo manifesto.
+            }
+        }
+        catch (err) {
+            results.push({
+                relPath: f.relPath,
+                action: "write-error",
+                detail: err.message,
+            });
+        }
+    }
+    // Prune: o que era nosso mas não veio nesta fonte.
+    if (prune) {
+        for (const [relPath, oldHash] of Object.entries(oldFiles)) {
+            if (incomingSet.has(relPath))
+                continue;
+            // Ainda existe no bundle (só foi filtrado pela seleção neste run) → NÃO poda;
+            // mantém no manifesto pra não perder a propriedade em runs futuros.
+            if (options.keep?.has(relPath)) {
+                newFiles[relPath] = oldHash;
+                continue;
+            }
+            const targetAbs = join(targetDir, relPath);
+            if (!existsSync(targetAbs))
+                continue;
+            const existingHash = sha256(readFileSync(targetAbs));
+            if (existingHash === oldHash) {
+                if (!dryRun)
+                    rmSync(targetAbs);
+                results.push({ relPath, action: "prune" });
+            }
+            else {
+                results.push({
+                    relPath,
+                    action: "prune-kept",
+                    detail: "modificado localmente — mantido",
+                });
+            }
+        }
+    }
+    if (!dryRun) {
+        const manifest = {
+            version: VERSION,
+            generator: brand.packageName,
+            files: newFiles,
+        };
+        mkdirSync(targetDir, { recursive: true });
+        writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+    }
+    return { targetDir, version: VERSION, dryRun, files: results };
+}
+/** Remove só o que o nio instalou (conforme o manifesto), preservando edições locais. */
+export function uninstallProvision(options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const targetDir = options.targetDir ?? defaultTargetDir();
+    const manifestPath = join(targetDir, MANIFEST_NAME);
+    const manifest = readManifest(manifestPath);
+    const removed = [];
+    const kept = [];
+    if (manifest) {
+        for (const [relPath, hash] of Object.entries(manifest.files)) {
+            const targetAbs = join(targetDir, relPath);
+            if (!existsSync(targetAbs))
+                continue;
+            if (sha256(readFileSync(targetAbs)) === hash) {
+                if (!dryRun)
+                    rmSync(targetAbs);
+                removed.push(relPath);
+            }
+            else {
+                kept.push(relPath);
+            }
+        }
+        if (!dryRun && existsSync(manifestPath))
+            rmSync(manifestPath);
+    }
+    return { targetDir, removed, kept, dryRun };
+}
+//# sourceMappingURL=provision-apply.js.map

package/dist/lib/provision-apply.js.map

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

package/dist/lib/provision-collect.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+/**
+ * Coleta os arquivos sincronizáveis do pacote `@nio-cli/skills` (commands/skills/
+ * agents) como uma lista em memória — a fonte que `provision()` filtra/achata
+ * (via `sections.ts`) e passa pro motor de aplicação (`provision-apply.ts`).
+ */
+/** Subpastas do pacote `@nio-cli/skills` espelhadas em `~/.claude`. */
+const SYNCED_SUBDIRS = ["commands", "skills", "agents"];
+/** Basenames que nunca são copiados pro destino (READMEs são só do repo). */
+const IGNORED_BASENAMES = new Set([".gitkeep", ".DS_Store", "README.md"]);
+/** Lista arquivos sob `dir` recursivamente, paths relativos a `dir` em estilo POSIX. */
+function listFilesRecursive(dir) {
+    const out = [];
+    const walk = (abs) => {
+        for (const entry of readdirSync(abs, { withFileTypes: true })) {
+            if (entry.name === ".DS_Store")
+                continue;
+            const childAbs = join(abs, entry.name);
+            if (entry.isDirectory())
+                walk(childAbs);
+            else if (entry.isFile())
+                out.push(relative(dir, childAbs).split(sep).join("/"));
+        }
+    };
+    walk(dir);
+    return out;
+}
+/** Coleta os arquivos sincronizáveis do pacote (só as subpastas conhecidas). */
+export function collectSkillFiles(dir) {
+    const files = [];
+    for (const sub of SYNCED_SUBDIRS) {
+        const subDir = join(dir, sub);
+        if (!existsSync(subDir))
+            continue;
+        for (const rel of listFilesRecursive(subDir)) {
+            const base = rel.split("/").pop() ?? rel;
+            if (IGNORED_BASENAMES.has(base))
+                continue;
+            const abs = join(subDir, rel);
+            const content = readFileSync(abs);
+            files.push({ relPath: `${sub}/${rel}`, content });
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=provision-collect.js.map

package/dist/lib/provision-collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision-collect.js","sourceRoot":"","sources":["../../src/lib/provision-collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;GAIG;AAEH,uEAAuE;AACvE,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAO1E,wFAAwF;AACxF,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;iBACnC,IAAI,KAAK,CAAC,MAAM,EAAE;gBACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAClC,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;YACzC,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/provision.js

@@ -0,0 +1,45 @@
+import { existsSync } from "node:fs";
+import { brand } from "../brand.js";
+import { claudeTarget } from "./targets.js";
+import { filterDocsForSurface, skillsDir } from "./skills.js";
+import { filterForSelection, flattenSelection } from "./sections.js";
+import { collectSkillFiles } from "./provision-collect.js";
+import { applyProvision } from "./provision-apply.js";
+/**
+ * Provisiona skills/commands/agents do nio (o MCP não grava em `~/.claude`; a CLI
+ * `sync`/`init` chama `provision()`). Idempotente via manifesto. Coleta em
+ * `provision-collect.ts`, motor em `provision-apply.ts` — ambos reexportados daqui.
+ */
+/**
+ * Copia/atualiza o conteúdo do pacote `@nio-cli/skills` no destino.
+ * (`nio sync` / `nio init`.)
+ */
+export function provision(options = {}) {
+    const target = options.target ?? claudeTarget;
+    const dir = options.skillsDir ?? skillsDir();
+    if (!existsSync(dir)) {
+        throw new Error(`Pacote de skills não encontrado em ${dir}. Instale/publique ${brand.skillsPackage}.`);
+    }
+    const rawDocs = collectSkillFiles(dir).map((f) => ({
+        relPath: f.relPath,
+        content: f.content,
+    }));
+    // Todos os paths on-disk possíveis do bundle (sem o filtro de seleção). O prune só
+    // remove o que NÃO está aqui — o que saiu do bundle de verdade —, nunca o que foi só
+    // filtrado pela seleção deste run. Sem isso o auto-pull de um repo com seleção estreita
+    // apagava `/implement` & cia. do `~/.claude` global.
+    const keep = new Set(target
+        .mapDocs(filterDocsForSurface(flattenSelection(rawDocs), target.surface))
+        .map((d) => d.relPath));
+    const scoped = filterForSelection(rawDocs, options.selection);
+    const flat = flattenSelection(scoped);
+    const visible = filterDocsForSurface(flat, target.surface);
+    const docs = target.mapDocs(visible);
+    return applyProvision(docs, {
+        ...options,
+        keep,
+        targetDir: options.targetDir ?? target.targetDir(),
+    });
+}
+export { MANIFEST_NAME, applyProvision, ensureDir, uninstallProvision, } from "./provision-apply.js";
+//# sourceMappingURL=provision.js.map

package/dist/lib/provision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.js","sourceRoot":"","sources":["../../src/lib/provision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAwB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAkB,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAA+C,MAAM,sBAAsB,CAAC;AAEnG;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,UAAkF,EAAE;IAEpF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,sBAAsB,KAAK,CAAC,aAAa,GAAG,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAC;IAEJ,mFAAmF;IACnF,qFAAqF;IACrF,wFAAwF;IACxF,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,MAAM;SACH,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;SACxE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CACzB,CAAC;IAEF,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,cAAc,CAAC,IAAI,EAAE;QAC1B,GAAG,OAAO;QACV,IAAI;QACJ,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,EAAE;KACnD,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,GAOnB,MAAM,sBAAsB,CAAC"}

package/dist/lib/require-config.js

@@ -0,0 +1,32 @@
+import { UUID_REGEX } from '../config.js';
+import { errorResult } from './tool-result.js';
+import { loadActiveProjectId } from './active-project.js';
+import { brand } from '../brand.js';
+/**
+ * Resolve o projeto efetivo de uma chamada, na ordem:
+ *   1. project_id explícito passado na tool (override por chamada)
+ *   2. projeto ativo da sessão (`nos_set_project`, só em memória)
+ *   3. default do ambiente/arquivo (NIO_PROJECT_ID / nio.json)
+ *
+ * O repository_id default só é aplicado quando o projeto resolvido é o mesmo do
+ * default — evita herdar um repositório de outro projeto.
+ */
+export function resolveProjectConfig(ctx, explicitProjectId) {
+    const projectId = explicitProjectId ?? loadActiveProjectId() ?? ctx.config?.project_id;
+    if (!projectId) {
+        return errorResult(`Nenhum projeto selecionado. Use \`${brand.toolPrefix}list_projects\` para ver os seus e ` +
+            `\`${brand.toolPrefix}set_project\` para escolher um (ou passe \`project_id\` direto na chamada).`);
+    }
+    if (!UUID_REGEX.test(projectId)) {
+        return errorResult(`project_id inválido (UUID esperado): ${projectId}`);
+    }
+    const config = { project_id: projectId };
+    if (projectId === ctx.config?.project_id && ctx.config?.repository_id) {
+        config.repository_id = ctx.config.repository_id;
+    }
+    return config;
+}
+export function isErrorResult(value) {
+    return typeof value === 'object' && value !== null && 'isError' in value;
+}
+//# sourceMappingURL=require-config.js.map

package/dist/lib/require-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-config.js","sourceRoot":"","sources":["../../src/lib/require-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAsB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAgB,EAChB,iBAA0B;IAE1B,MAAM,SAAS,GAAG,iBAAiB,IAAI,mBAAmB,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAEvF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,WAAW,CAChB,qCAAqC,KAAK,CAAC,UAAU,qCAAqC;YACxF,KAAK,KAAK,CAAC,UAAU,6EAA6E,CACrG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACxD,IAAI,SAAS,KAAK,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;QACtE,MAAM,CAAC,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK,CAAC;AAC3E,CAAC"}

package/dist/lib/rules.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { skillsDir } from './skills.js';
+import { DEV_ROLE, GENERAL } from './sections.js';
+/**
+ * Rules do harness — convenções versionadas no `nio-skills`, na mesma taxonomia
+ * da seleção: `rules/<role>/<área|general>/<stack|general>/rules.md`. O geral do role
+ * fica em `rules/<role>/general/general-rules.md`.
+ *
+ * Este módulo lê + concatena (determinístico) pela `Selection`, e o CLI grava o
+ * resultado no repo (`docs/_rules`). Rules são de código → só o role `dev`.
+ */
+const RULES_ROOT = 'rules';
+function rulePath(dir, ...seg) {
+    return join(dir, RULES_ROOT, ...seg);
+}
+/** Separa o frontmatter (`--- … ---`) do corpo. */
+function splitFrontmatter(raw) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(raw);
+    if (!m)
+        return { fm: {}, body: raw };
+    const fm = {};
+    for (const line of m[1].split(/\r?\n/)) {
+        const mm = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        if (mm)
+            fm[mm[1]] = mm[2].trim();
+    }
+    return { fm, body: raw.slice(m[0].length) };
+}
+/** Rebaixa headings um nível (`##` → `###`) pra aninharem sob o cabeçalho do bloco. */
+function demoteHeadings(md) {
+    return md.replace(/^(#{1,5})(\s)/gm, '#$1$2');
+}
+/** Corpo (sem frontmatter, headings rebaixados) de um arquivo de regra, ou `null`. */
+function readRuleBody(path) {
+    if (!existsSync(path))
+        return null;
+    const body = splitFrontmatter(readFileSync(path, 'utf8')).body.trim();
+    return body.length > 0 ? demoteHeadings(body) : null;
+}
+/** Skills recomendadas (frontmatter `skills:`) de um arquivo de regra. */
+function ruleSkillsAt(path) {
+    if (!existsSync(path))
+        return [];
+    return (splitFrontmatter(readFileSync(path, 'utf8')).fm.skills ?? '')
+        .split(/[,\s]+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/** Arquivo de regra geral do role (`rules/<role>/general/general-rules.md`, ou `rules.md`). */
+function generalRule(dir) {
+    const named = rulePath(dir, DEV_ROLE, GENERAL, 'general-rules.md');
+    return existsSync(named) ? named : rulePath(dir, DEV_ROLE, GENERAL, 'rules.md');
+}
+/**
+ * Concatena o harness pela seleção: geral do role + (por área selecionada) o geral da
+ * área + o **stack** escolhido. Ordenado (general → áreas alfabéticas). String vazia se
+ * nada aplicável. Só o role `dev` tem rules.
+ */
+export function concatenateRules(sel, dir = skillsDir()) {
+    if (!sel.roles.includes(DEV_ROLE))
+        return '';
+    const blocks = [];
+    const general = readRuleBody(generalRule(dir));
+    if (general)
+        blocks.push(`## general\n\n${general}`);
+    for (const area of Object.keys(sel.stacks).sort()) {
+        const areaGeneral = readRuleBody(rulePath(dir, DEV_ROLE, area, GENERAL, 'rules.md'));
+        if (areaGeneral)
+            blocks.push(`## ${area}\n\n${areaGeneral}`);
+        const stack = sel.stacks[area];
+        if (stack && stack !== GENERAL) {
+            const body = readRuleBody(rulePath(dir, DEV_ROLE, area, stack, 'rules.md'));
+            if (body)
+                blocks.push(`## ${area} · ${stack}\n\n${body}`);
+        }
+    }
+    return blocks.join('\n\n');
+}
+/**
+ * Skills recomendadas (skills.sh, do frontmatter `skills:`) das áreas/stacks
+ * selecionadas — do `rules.md` da área + do stack escolhido. Deduplicado.
+ */
+export function collectRuleSkills(sel, dir = skillsDir()) {
+    if (!sel.roles.includes(DEV_ROLE))
+        return [];
+    const out = new Set();
+    for (const area of Object.keys(sel.stacks)) {
+        for (const s of ruleSkillsAt(rulePath(dir, DEV_ROLE, area, GENERAL, 'rules.md')))
+            out.add(s);
+        const stack = sel.stacks[area];
+        if (stack && stack !== GENERAL) {
+            for (const s of ruleSkillsAt(rulePath(dir, DEV_ROLE, area, stack, 'rules.md')))
+                out.add(s);
+        }
+    }
+    return [...out];
+}
+//# sourceMappingURL=rules.js.map

package/dist/lib/rules.js.map

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

package/dist/lib/sections.js

@@ -0,0 +1,89 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Seleção unificada de conteúdo por **role → área → stack**, com `general` em cascata.
+ * Um só modelo dita skills, rules e dependencies — o que o usuário preenche no `init`
+ * filtra os três igual.
+ *
+ * Taxonomia (uniforme nos kinds versionados):
+ *   skills/<role>/<área|general>/<stack|general>/<skill>/SKILL.md
+ *   rules/<role>/<área|general>/<stack|general>/rules.md
+ *   dependencies/<role>/<área|general>/<stack|general>/*.md
+ *   agents/<role>/<name>.md          (role, sem área/stack)
+ *   commands/<name>.md  ·  hooks/*    (flat — sempre dev)
+ *
+ * Regra de inclusão: role selecionado; `general` do role entra sempre; uma área só
+ * entra se selecionada, e dentro dela só o `general` da área + o **stack escolhido**.
+ */
+export const GENERAL = 'general';
+export const DEV_ROLE = 'dev';
+/** Roles = subpastas de topo de `skills/` (ex.: `dev`, `management`). */
+export function discoverRoles(dir) {
+    return subdirs(join(dir, 'skills'));
+}
+/** Áreas de um role = subpastas de `skills/<role>/` menos `general`. */
+export function discoverAreas(dir, role) {
+    return subdirs(join(dir, 'skills', role)).filter((a) => a !== GENERAL);
+}
+/** Stacks de uma área = subpastas de `skills/<role>/<área>/` menos `general`. */
+export function discoverStacks(dir, role, area) {
+    return subdirs(join(dir, 'skills', role, area)).filter((s) => s !== GENERAL);
+}
+function subdirs(root) {
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
+        .map((e) => e.name)
+        .sort();
+}
+/**
+ * Um path é incluído na seleção? Vale pra qualquer kind — aplica a gramática da taxonomia.
+ * `commands`/`hooks` são flat e sempre-dev; `agents` filtra por role; `skills`/`rules`/
+ * `dependencies` filtram por role → área → stack com `general` em cascata.
+ */
+export function includePath(relPath, sel) {
+    const parts = relPath.split('/');
+    const kind = parts[0];
+    if (kind === 'commands' || kind === 'hooks')
+        return sel.roles.includes(DEV_ROLE);
+    const role = parts[1];
+    if (!sel.roles.includes(role))
+        return false;
+    if (kind === 'agents')
+        return true; // role já bateu; agents não têm área/stack
+    const seg2 = parts[2];
+    if (seg2 === undefined || seg2 === GENERAL)
+        return true; // geral do role
+    if (!(seg2 in sel.stacks))
+        return false; // área não selecionada
+    const seg3 = parts[3];
+    return seg3 === GENERAL || seg3 === sel.stacks[seg2]; // geral da área ou stack escolhido
+}
+/** Filtra docs pela seleção. `undefined` → tudo (sem filtro). */
+export function filterForSelection(docs, sel) {
+    if (!sel)
+        return docs;
+    return docs.filter((d) => includePath(d.relPath, sel));
+}
+/**
+ * Achata os segmentos de taxonomia pro layout on-disk do cliente:
+ *   skills/<role>/general/<skill>/…            → skills/<skill>/…
+ *   skills/<role>/<área>/<stack>/<skill>/…      → skills/<skill>/…
+ *   agents/<role>/<name>                        → agents/<name>
+ *   commands/<name>  ·  hooks/*                  → inalterado (já flat)
+ */
+export function flattenSelection(docs) {
+    return docs.map((d) => {
+        const parts = d.relPath.split('/');
+        const kind = parts[0];
+        if (kind === 'agents')
+            return { ...d, relPath: `agents/${parts.slice(2).join('/')}` };
+        if (kind === 'skills') {
+            const rest = parts[2] === GENERAL ? parts.slice(3) : parts.slice(4);
+            return { ...d, relPath: `skills/${rest.join('/')}` };
+        }
+        return d;
+    });
+}
+//# sourceMappingURL=sections.js.map

package/dist/lib/sections.js.map

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