jarvis-ai-framework 1.0.0

package/bin/lib/vcs/api.js

@@ -0,0 +1,312 @@
+import { parseRepoUrl, mergeRequestPath } from "../utils/git-parser.js";
+import { getVcsToken } from "../utils/npmrc-parser.js";
+
+function authHeaders(vendor, token) {
+  if (vendor === "gitlab") {
+    return { "PRIVATE-TOKEN": token };
+  }
+  if (vendor === "github") {
+    return {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.github+json",
+      "X-GitHub-Api-Version": "2022-11-28",
+    };
+  }
+  return {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/json",
+  };
+}
+
+async function request(url, { method = "GET", headers = {}, body } = {}) {
+  const res = await fetch(url, {
+    method,
+    headers: {
+      "Content-Type": "application/json",
+      ...headers,
+    },
+    body: body != null ? JSON.stringify(body) : undefined,
+  });
+  const text = await res.text();
+  let json = null;
+  try {
+    json = text ? JSON.parse(text) : null;
+  } catch {
+    json = { raw: text };
+  }
+  return { ok: res.ok, status: res.status, json, text };
+}
+
+export async function fetchRawFile(repoUrl, filePath, ref = "main") {
+  const repo = parseRepoUrl(repoUrl);
+  const token = getVcsToken(repo.vendor);
+  const headers = authHeaders(repo.vendor, token);
+  const encodedPath = encodeURIComponent(filePath);
+
+  let url;
+  if (repo.vendor === "gitlab") {
+    url = `${repo.apiBase}/projects/${repo.projectPathEncoded}/repository/files/${encodedPath}/raw?ref=${encodeURIComponent(ref)}`;
+  } else if (repo.vendor === "github") {
+    url = `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/contents/${filePath}?ref=${encodeURIComponent(ref)}`;
+    headers.Accept = "application/vnd.github.raw";
+  } else {
+    url = `${repo.apiBase}/repositories/${repo.owner}/${repo.repo}/src/${encodeURIComponent(ref)}/${filePath}`;
+  }
+
+  const res = await fetch(url, { headers });
+  if (res.status === 404) {
+    const err = new Error(`not_found:${filePath}`);
+    err.code = 404;
+    throw err;
+  }
+  if (res.status === 401 || res.status === 403) {
+    const err = new Error(`unauthorized:${repo.vendor}`);
+    err.code = res.status;
+    throw err;
+  }
+  if (!res.ok) {
+    throw new Error(`fetch failed ${res.status}: ${await res.text()}`);
+  }
+  return await res.text();
+}
+
+export async function createMergeRequest(repoUrl, opts) {
+  const { source, target, title, description = "" } = opts;
+  const repo = parseRepoUrl(repoUrl);
+  const token = getVcsToken(repo.vendor);
+  const headers = authHeaders(repo.vendor, token);
+
+  if (repo.vendor === "gitlab") {
+    const { ok, status, json } = await request(
+      `${repo.apiBase}/projects/${repo.projectPathEncoded}/merge_requests`,
+      {
+        method: "POST",
+        headers,
+        body: {
+          source_branch: source,
+          target_branch: target,
+          title,
+          description,
+          remove_source_branch: true,
+        },
+      },
+    );
+    if (!ok || !json?.web_url) {
+      throw new Error(
+        `Falha ao criar MR GitLab (${status}): ${JSON.stringify(json)}`,
+      );
+    }
+    return { vendor: "gitlab", iid: json.iid, url: json.web_url };
+  }
+
+  if (repo.vendor === "github") {
+    const { ok, status, json } = await request(
+      `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/pulls`,
+      {
+        method: "POST",
+        headers,
+        body: {
+          title,
+          head: source,
+          base: target,
+          body: description,
+        },
+      },
+    );
+    if (!ok || !json?.html_url) {
+      throw new Error(
+        `Falha ao criar PR GitHub (${status}): ${JSON.stringify(json)}`,
+      );
+    }
+    return { vendor: "github", iid: json.number, url: json.html_url };
+  }
+
+  const { ok, status, json } = await request(
+    `${repo.apiBase}/repositories/${repo.owner}/${repo.repo}/pullrequests`,
+    {
+      method: "POST",
+      headers,
+      body: {
+        title,
+        description,
+        source: { branch: { name: source } },
+        destination: { branch: { name: target } },
+        close_source_branch: true,
+      },
+    },
+  );
+  if (!ok || !json?.links?.html?.href) {
+    throw new Error(
+      `Falha ao criar PR Bitbucket (${status}): ${JSON.stringify(json)}`,
+    );
+  }
+  return {
+    vendor: "bitbucket",
+    iid: json.id,
+    url: json.links.html.href,
+  };
+}
+
+/**
+ * Commit de um ou mais arquivos numa branch nova (docs publish).
+ * files: [{ path, contentBase64, action: 'create'|'update' }]
+ */
+export async function commitFiles(repoUrl, opts) {
+  const { branch, startBranch, message, files } = opts;
+  const repo = parseRepoUrl(repoUrl);
+  const token = getVcsToken(repo.vendor);
+  const headers = authHeaders(repo.vendor, token);
+
+  if (repo.vendor === "gitlab") {
+    const { ok, status, json } = await request(
+      `${repo.apiBase}/projects/${repo.projectPathEncoded}/repository/commits`,
+      {
+        method: "POST",
+        headers,
+        body: {
+          branch,
+          start_branch: startBranch,
+          commit_message: message,
+          actions: files.map((f) => ({
+            action: f.action || "create",
+            file_path: f.path,
+            content: f.contentBase64,
+            encoding: "base64",
+          })),
+        },
+      },
+    );
+    if (!ok || !json?.id) {
+      throw new Error(
+        `Falha no commit GitLab (${status}): ${JSON.stringify(json)}`,
+      );
+    }
+    return { sha: json.id };
+  }
+
+  if (repo.vendor === "github") {
+    const refRes = await request(
+      `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/git/ref/heads/${startBranch}`,
+      { headers },
+    );
+    if (!refRes.ok) {
+      throw new Error(
+        `Branch ${startBranch} não encontrada no GitHub (${refRes.status})`,
+      );
+    }
+    const sha = refRes.json.object.sha;
+    await request(
+      `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/git/refs`,
+      {
+        method: "POST",
+        headers,
+        body: { ref: `refs/heads/${branch}`, sha },
+      },
+    );
+    let lastSha = sha;
+    for (const file of files) {
+      const put = await request(
+        `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/contents/${file.path}`,
+        {
+          method: "PUT",
+          headers,
+          body: {
+            message,
+            content: file.contentBase64,
+            branch,
+          },
+        },
+      );
+      if (!put.ok) {
+        throw new Error(
+          `Falha ao escrever ${file.path} no GitHub (${put.status}): ${JSON.stringify(put.json)}`,
+        );
+      }
+      lastSha = put.json.commit?.sha || lastSha;
+    }
+    return { sha: lastSha };
+  }
+
+  const form = new FormData();
+  form.set("branch", branch);
+  form.set("parents", startBranch);
+  form.set("message", message);
+  for (const file of files) {
+    const buf = Buffer.from(file.contentBase64, "base64");
+    form.set(file.path, new Blob([buf]));
+  }
+  const res = await fetch(
+    `${repo.apiBase}/repositories/${repo.owner}/${repo.repo}/src`,
+    {
+      method: "POST",
+      headers: { Authorization: `Bearer ${token}` },
+      body: form,
+    },
+  );
+  if (!res.ok) {
+    throw new Error(`Falha no commit Bitbucket (${res.status}): ${await res.text()}`);
+  }
+  return { sha: "ok" };
+}
+
+export async function createIssue(repoUrl, opts) {
+  const { title, body, labels = ["bug"] } = opts;
+  const repo = parseRepoUrl(repoUrl);
+  const token = getVcsToken(repo.vendor);
+  const headers = authHeaders(repo.vendor, token);
+
+  if (repo.vendor === "gitlab") {
+    const { ok, status, json } = await request(
+      `${repo.apiBase}/projects/${repo.projectPathEncoded}/issues`,
+      {
+        method: "POST",
+        headers,
+        body: { title, description: body, labels: labels.join(",") },
+      },
+    );
+    if (!ok || !json?.web_url) {
+      throw new Error(`Issue GitLab (${status}): ${JSON.stringify(json)}`);
+    }
+    return { vendor: "gitlab", iid: json.iid, url: json.web_url };
+  }
+
+  if (repo.vendor === "github") {
+    const { ok, status, json } = await request(
+      `${repo.apiBase}/repos/${repo.owner}/${repo.repo}/issues`,
+      {
+        method: "POST",
+        headers,
+        body: { title, body, labels },
+      },
+    );
+    if (!ok || !json?.html_url) {
+      throw new Error(`Issue GitHub (${status}): ${JSON.stringify(json)}`);
+    }
+    return { vendor: "github", iid: json.number, url: json.html_url };
+  }
+
+  const { ok, status, json } = await request(
+    `${repo.apiBase}/repositories/${repo.owner}/${repo.repo}/issues`,
+    {
+      method: "POST",
+      headers,
+      body: { title, content: { raw: body } },
+    },
+  );
+  if (!ok || !json?.links?.html?.href) {
+    throw new Error(`Issue Bitbucket (${status}): ${JSON.stringify(json)}`);
+  }
+  return { vendor: "bitbucket", iid: json.id, url: json.links.html.href };
+}
+
+export function cardUrl(taskManager, baseUrl, cardKey) {
+  const tm = String(taskManager || "jira").toLowerCase();
+  const base = String(baseUrl || "").replace(/\/$/, "");
+  if (!base) return cardKey;
+  if (tm === "linear") return `${base}/issue/${cardKey}`;
+  if (tm === "github") return `${base}/issues/${cardKey.replace(/^#/, "")}`;
+  if (tm === "asana") return `${base}/0/0/${cardKey}`;
+  return `${base}/browse/${cardKey}`;
+}
+
+export { parseRepoUrl, mergeRequestPath, getVcsToken };

package/bin/lib/vcs/create-issue.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "node:fs";
+import { createIssue, parseRepoUrl } from "./api.js";
+
+function arg(name, fallback = "") {
+  const idx = process.argv.indexOf(`--${name}`);
+  if (idx === -1) return fallback;
+  return process.argv[idx + 1] || fallback;
+}
+
+const title = arg("title");
+const bodyFile = arg("body-file");
+const repo = arg("repo");
+
+if (!title || !bodyFile || !repo) {
+  console.error(
+    "Uso: create-issue.js --repo <url-ou-path> --title <titulo> --body-file <path>",
+  );
+  process.exit(1);
+}
+
+let repoUrl = repo.trim();
+if (!/^https?:\/\//.test(repoUrl) && !repoUrl.includes("@")) {
+  const hostGuess = (process.env.VERSION_CONTROL || "gitlab").toLowerCase();
+  const host =
+    hostGuess === "github"
+      ? "github.com"
+      : hostGuess === "bitbucket"
+        ? "bitbucket.org"
+        : "gitlab.com";
+  repoUrl = `https://${host}/${repoUrl.replace(/^\/+/, "")}`;
+}
+
+const body = existsSync(bodyFile) ? readFileSync(bodyFile, "utf-8") : "";
+
+try {
+  const result = await createIssue(repoUrl, { title, body });
+  parseRepoUrl(repoUrl);
+  console.log(`✅ Issue aberto: ${result.url}`);
+  console.log(JSON.stringify(result));
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}

package/bin/lib/vcs/create-merge.js

@@ -0,0 +1,43 @@
+import { execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { createMergeRequest, parseRepoUrl } from "./api.js";
+
+function arg(name, fallback = "") {
+  const idx = process.argv.indexOf(`--${name}`);
+  if (idx === -1) return fallback;
+  return process.argv[idx + 1] || fallback;
+}
+
+const source = arg("source");
+const target = arg("target");
+const title = arg("title");
+const bodyFile = arg("body-file");
+const repoArg = arg("repo");
+
+if (!source || !target || !title) {
+  console.error(
+    "Uso: create-merge.js --source <branch> --target <branch> --title <titulo> [--body-file path] [--repo url]",
+  );
+  process.exit(1);
+}
+
+const repoUrl =
+  repoArg ||
+  execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+const description = bodyFile ? readFileSync(bodyFile, "utf-8") : "";
+
+try {
+  const result = await createMergeRequest(repoUrl, {
+    source,
+    target,
+    title,
+    description,
+  });
+  const parsed = parseRepoUrl(repoUrl);
+  const noun = parsed.vendor === "gitlab" ? "MR" : "PR";
+  console.log(`✅ ${noun} criado: ${result.url}`);
+  console.log(JSON.stringify(result));
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}

package/bin/lib/vcs/fetch-raw.js

@@ -0,0 +1,30 @@
+import { fetchRawFile } from "./api.js";
+
+const filePath = process.argv[2];
+const ref = process.argv[3] || "main";
+const repo = process.env.CENTRAL_DOCS_REPO;
+
+if (!filePath) {
+  console.error("Uso: fetch-raw.js <file-path> [ref]");
+  process.exit(1);
+}
+if (!repo) {
+  console.error("CENTRAL_DOCS_REPO não definido");
+  process.exit(1);
+}
+
+try {
+  const content = await fetchRawFile(repo, filePath, ref);
+  process.stdout.write(content);
+} catch (err) {
+  if (err.code === 404) {
+    console.error(`⚠️  Arquivo não encontrado no central-docs: ${filePath}`);
+    process.exit(2);
+  }
+  if (err.code === 401 || err.code === 403) {
+    console.error("❌ Token sem permissão para acessar o repositório");
+    process.exit(1);
+  }
+  console.error(err.message);
+  process.exit(1);
+}

package/bin/postinstall.js

@@ -0,0 +1,41 @@
+import { existsSync, readFileSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const cwd = process.env.INIT_CWD || process.cwd();
+const lockPath = join(cwd, "jarvis-lock.json");
+
+// ── Sincronizar assets para projetos com jarvis-lock.json ───────────────────
+if (existsSync(lockPath)) {
+  try {
+    const lock = JSON.parse(readFileSync(lockPath, "utf-8"));
+    const { syncAssets } = await import("./lib/core/sync-engine.js");
+    const { getWorkflowsFolder } = await import("./lib/config/ide-config.js");
+    const { logger } = await import("./lib/utils/logger.js");
+    logger.info(`\n  jarvis-framework — syncing to .${lock.ide}/\n`);
+    const result = syncAssets(cwd, lock.ide, {
+      force: true,
+      workflowsFolder: getWorkflowsFolder(lock.ide),
+    });
+    logger.info(`  ${result.copied.length} items synced.\n`);
+  } catch {}
+} else {
+  const { logger } = await import("./lib/utils/logger.js");
+  logger.info(`
+  jarvis-framework installed.
+  Run: npx jarvis init --ide windsurf
+`);
+}
+
+// ── Sugestão RTK (sempre, se rtk não estiver instalado) ─────────────────────
+try {
+  execSync("which rtk 2>/dev/null", { stdio: "pipe" });
+} catch {
+  const { logger } = await import("./lib/utils/logger.js");
+  logger.info(`  💡 Dica: instale o RTK para economizar 60-90% dos tokens de shell.`);
+  logger.info(`     npx jarvis install-rtk\n`);
+}

package/members.md

@@ -0,0 +1,25 @@
+# Members
+
+Lista de membros da organização com suas posições, squads e identificadores.
+
+> **Formato**: `Nome Completo | email | posição | slack_user_id`
+> **Squads válidos**: definidos em `taxonomy.md`
+> Preencha via `/members-manager` ou edite esta tabela.
+
+---
+
+## C-LEVEL
+
+Membros sem squad específico ou com atuação transversal.
+
+| Nome | Email | Posição | Slack ID |
+|------|-------|---------|----------|
+
+---
+
+## HEADS
+
+Membros sem squad específico ou com atuação transversal.
+
+| Nome | Email | Posição | Slack ID |
+|------|-------|---------|----------|

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "jarvis-ai-framework",
+  "version": "1.0.0",
+  "description": "Jarvis framework",
+  "type": "module",
+  "bin": {
+    "jarvis": "./bin/jarvis.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/postinstall.js",
+    "prepublishOnly": "echo 'Publishing jarvis-framework...'",
+    "publish:gitlab": "npm publish",
+    "test": "node test/e2e-docs-central.js",
+    "test:utils": "node test/test-phase1-utils.js",
+    "test:all": "npm run test:utils && npm run test"
+  },
+  "files": [
+    "bin/",
+    "agents/",
+    "skills/",
+    "workflows/",
+    "templates/",
+    "rules/",
+    "taxonomy.md",
+    "members.md",
+    "AGENTS.md",
+    "README.md"
+  ],
+  "keywords": [
+    "ai-prompts",
+    "agents",
+    "workflows",
+    "claude",
+    "windsurf",
+    "cursor",
+    "mcp"
+  ],
+  "author": "Felipe Ribeiro de Andrade",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phelipperibeiro/jarvis-framework.git"
+  },
+  "homepage": "https://github.com/phelipperibeiro/jarvis-framework",
+  "bugs": {
+    "url": "https://github.com/phelipperibeiro/jarvis-framework/issues"
+  },
+  "dependencies": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "sharp": "^0.34.5"
+  }
+}