oxe-cc 1.2.1 → 1.4.0

package/bin/banner.txt

@@ -7,12 +7,12 @@
 
 ══════════════════════════════════════════════════════
 
-        🌵 OXE CLI · Spec-driven workflow
-        "Do jeito nordestino de fazer software"
-
-        ⚙️  Context Engineering
-        🤖  Multi-IDE · Cursor · Copilot · +CLIs
+        🌵 OXE CLI · Runtime Enterprise
+        "Spec-driven workflow com estado canónico"
+
+        ⚙️  Context Engineering · Evidence-first Verify
+        🤖  Multi-IDE · Copilot · Cursor · +CLIs
 
 ══════════════════════════════════════════════════════
 
-                     v{version}
+                     v{version}

package/bin/lib/oxe-agent-install.cjs

@@ -8,10 +8,10 @@
  * Com `--ide-local`, destinos equivalentes sob a raiz do projeto (ex.: ./.opencode/commands).
  */
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const runtimeSemantics = require('./oxe-runtime-semantics.cjs');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const runtimeSemantics = require('./oxe-runtime-semantics.cjs');
 
 const OXE_MANAGED_HTML = '<!-- oxe-cc managed -->';
 const OXE_MANAGED_TOML = '# oxe-cc managed';
@@ -76,55 +76,55 @@ function adjustWorkflowPathsForNestedLayout(content) {
 
 /**
  * @param {string} text
- * @returns {{ description: string, body: string, frontmatter: Record<string, string> }}
- */
-function parseCursorCommandFrontmatter(text) {
-  const normalized = text.replace(/\r\n/g, '\n');
-  if (!normalized.startsWith('---\n')) {
-    return { description: '', body: normalized.trim(), frontmatter: {} };
-  }
-  const end = normalized.indexOf('\n---\n', 4);
-  if (end === -1) {
-    return { description: '', body: normalized.trim(), frontmatter: {} };
-  }
-  const yamlBlock = normalized.slice(4, end);
-  const frontmatter = {};
-  let description = '';
-  for (const line of yamlBlock.split('\n')) {
-    const m = line.match(/^description:\s*(.+)$/);
-    if (m) {
-      description = m[1].trim().replace(/^["']|["']$/g, '');
-    }
-    const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.+)$/);
-    if (kv) frontmatter[kv[1]] = kv[2].trim().replace(/^["']|["']$/g, '');
-  }
-  const body = normalized.slice(end + 5).trim();
-  return { description, body, frontmatter };
-}
+ * @returns {{ description: string, body: string, frontmatter: Record<string, string> }}
+ */
+function parseCursorCommandFrontmatter(text) {
+  const normalized = text.replace(/\r\n/g, '\n');
+  if (!normalized.startsWith('---\n')) {
+    return { description: '', body: normalized.trim(), frontmatter: {} };
+  }
+  const end = normalized.indexOf('\n---\n', 4);
+  if (end === -1) {
+    return { description: '', body: normalized.trim(), frontmatter: {} };
+  }
+  const yamlBlock = normalized.slice(4, end);
+  const frontmatter = {};
+  let description = '';
+  for (const line of yamlBlock.split('\n')) {
+    const m = line.match(/^description:\s*(.+)$/);
+    if (m) {
+      description = m[1].trim().replace(/^["']|["']$/g, '');
+    }
+    const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.+)$/);
+    if (kv) frontmatter[kv[1]] = kv[2].trim().replace(/^["']|["']$/g, '');
+  }
+  const body = normalized.slice(end + 5).trim();
+  return { description, body, frontmatter };
+}
 
 /**
  * @param {string} skillName
  * @param {string} description
- * @param {string} body
- * @param {Record<string, string>} [metadata]
- */
-function buildAgentSkillMarkdown(skillName, description, body, metadata) {
-  const desc = description.trim() || `Comando OXE — ${skillName}`;
-  const meta = metadata ? runtimeSemantics.pickRuntimeMetadata(metadata) : {};
-  const metaLines = Object.keys(meta).length
-    ? `${runtimeSemantics.renderRuntimeMetadataLines(meta).join('\n')}\n`
-    : '';
-  return (
-    `---\n` +
-    `name: ${skillName}\n` +
-    `description: ${JSON.stringify(desc)}\n` +
-    `user-invocable: true\n` +
-    metaLines +
-    `---\n\n` +
-    `${OXE_MANAGED_HTML}\n\n` +
-    `${body}\n`
-  );
-}
+ * @param {string} body
+ * @param {Record<string, string>} [metadata]
+ */
+function buildAgentSkillMarkdown(skillName, description, body, metadata) {
+  const desc = description.trim() || `Comando OXE — ${skillName}`;
+  const meta = metadata ? runtimeSemantics.pickRuntimeMetadata(metadata) : {};
+  const metaLines = Object.keys(meta).length
+    ? `${runtimeSemantics.renderRuntimeMetadataLines(meta).join('\n')}\n`
+    : '';
+  return (
+    `---\n` +
+    `name: ${skillName}\n` +
+    `description: ${JSON.stringify(desc)}\n` +
+    `user-invocable: true\n` +
+    metaLines +
+    `---\n\n` +
+    `${OXE_MANAGED_HTML}\n\n` +
+    `${body}\n`
+  );
+}
 
 /**
  * @returns {string[]}
@@ -190,9 +190,9 @@ function installSkillTreeFromCursorCommands(cCmdSrc, skillsRoot, opts, pathRewri
   const writeOne = (skillName, srcPath, descSuffix) => {
     let raw = fs.readFileSync(srcPath, 'utf8');
     if (pathRewriteNested) raw = adjustWorkflowPathsForNestedLayout(raw);
-    const { description, body, frontmatter } = parseCursorCommandFrontmatter(raw);
-    const desc = descSuffix ? `${description.trim()} ${descSuffix}`.trim() : description.trim();
-    const md = buildAgentSkillMarkdown(skillName, desc, body, frontmatter);
+    const { description, body, frontmatter } = parseCursorCommandFrontmatter(raw);
+    const desc = descSuffix ? `${description.trim()} ${descSuffix}`.trim() : description.trim();
+    const md = buildAgentSkillMarkdown(skillName, desc, body, frontmatter);
     const destDir = path.join(skillsRoot, skillName);
     const dest = path.join(destDir, 'SKILL.md');
     if (opts.dryRun) {
@@ -257,8 +257,8 @@ function installGeminiTomlCommands(cCmdSrc, paths, opts, pathRewriteNested, logO
   const writeToml = (relPath, srcPath, descSuffix) => {
     let raw = fs.readFileSync(srcPath, 'utf8');
     if (pathRewriteNested) raw = adjustWorkflowPathsForNestedLayout(raw);
-    const { description, body } = parseCursorCommandFrontmatter(raw);
-    const desc = descSuffix ? `${description} ${descSuffix}`.trim() : description;
+    const { description, body } = parseCursorCommandFrontmatter(raw);
+    const desc = descSuffix ? `${description} ${descSuffix}`.trim() : description;
     const toml = buildGeminiToml(desc, body);
     const dest = path.join(base, relPath);
     if (opts.dryRun) {
@@ -307,8 +307,8 @@ function installWindsurfGlobalWorkflows(cCmdSrc, paths, opts, pathRewriteNested,
     }
     let raw = fs.readFileSync(src, 'utf8');
     if (pathRewriteNested) raw = adjustWorkflowPathsForNestedLayout(raw);
-    const { description, body } = parseCursorCommandFrontmatter(raw);
-    const title = description || name.replace(/\.md$/i, '');
+    const { description, body } = parseCursorCommandFrontmatter(raw);
+    const title = description || name.replace(/\.md$/i, '');
     const out =
       `---\n` +
       `description: ${JSON.stringify(title)}\n` +
@@ -362,19 +362,19 @@ function installCodexPrompts(cCmdSrc, paths, opts, pathRewriteNested, logOmitido
     }
     let raw = fs.readFileSync(src, 'utf8');
     if (pathRewriteNested) raw = adjustWorkflowPathsForNestedLayout(raw);
-    const { description, body, frontmatter } = parseCursorCommandFrontmatter(raw);
-    const meta = runtimeSemantics.pickRuntimeMetadata(frontmatter);
-    const metaLines = Object.keys(meta).length
-      ? `${runtimeSemantics.renderRuntimeMetadataLines(meta).join('\n')}\n`
-      : '';
-    const out =
-      `---\n` +
-      `description: ${JSON.stringify(description || 'OXE')}\n` +
-      `argument-hint: [texto livre opcional]\n` +
-      metaLines +
-      `---\n\n` +
-      `${OXE_MANAGED_HTML}\n\n` +
-      `${body}\n`;
+    const { description, body, frontmatter } = parseCursorCommandFrontmatter(raw);
+    const meta = runtimeSemantics.pickRuntimeMetadata(frontmatter);
+    const metaLines = Object.keys(meta).length
+      ? `${runtimeSemantics.renderRuntimeMetadataLines(meta).join('\n')}\n`
+      : '';
+    const out =
+      `---\n` +
+      `description: ${JSON.stringify(description || 'OXE')}\n` +
+      `argument-hint: [texto livre opcional]\n` +
+      metaLines +
+      `---\n\n` +
+      `${OXE_MANAGED_HTML}\n\n` +
+      `${body}\n`;
     fs.mkdirSync(destDir, { recursive: true });
     fs.writeFileSync(dest, out, 'utf8');
   }