wize-dev-kit 0.11.0 → 0.12.0

package/src/web-overlay/wize-web-seo-audit/workflow.md

@@ -1,5 +1,7 @@
 ---
+
 code: wize-web-seo-audit
+description: "Use quando o projeto web estiver no ar e precisar de auditoria de SEO."
 name: Web SEO Audit
 overlay: web
 owner: wize-agent-pm   # Maria Hill commissions; Mantis + Tony execute

package/tools/installer/commands/doctor.js

@@ -252,13 +252,13 @@ async function cmdDoctor({ kitRoot, projectRoot, opts = {} } = {}) {
       const age = f.days == null ? 'no last_refreshed' : `${f.days}d ago`;
       log(`  ${f.name.padEnd(28)} ${age}`);
       if (f.days != null && f.days > 60) {
-        suggestions.push({ level: 'warn', text: `\`${f.name}\` last refreshed ${f.days}d ago. Run \`wize-refresh-knowledge\` after current sprint.` });
+        suggestions.push({ level: 'warn', text: `\`${f.name}\` last refreshed ${f.days}d ago. Run \`/wize-refresh-knowledge\` after current sprint.` });
       }
     }
     if (knowledge.pendingLines > 0) {
       log(`  _pending.md:                ${knowledge.pendingLines} inline note(s) waiting consolidation`);
       if (knowledge.pendingLines >= 5) {
-        suggestions.push({ level: 'info', text: `${knowledge.pendingLines} notes piled up in _pending.md. Time to run \`wize-refresh-knowledge\`.` });
+        suggestions.push({ level: 'info', text: `${knowledge.pendingLines} notes piled up in _pending.md. Time to run \`/wize-refresh-knowledge\`.` });
       }
     }
     const markerText = knowledge.toBeGeneratedMarkers > 0 ? `${knowledge.toBeGeneratedMarkers} marker(s)` : 'none';

package/tools/installer/onboarding.js

@@ -1,32 +1,25 @@
 /*
  * Onboarding handoff — Wizer-driven triage after install.
  *
- * Stub: in v0.1 this just prints the first action Wizer would take.
- * In a real run this would be a workflow executed by the active IDE adapter.
+ * Returns a clean, minimal message (≤3 lines) that always ends with "→ /wize".
+ * The message adapts to brownfield detection and active profiles without
+ * turning into a wall of text.
  */
 'use strict';
 
 function compose(detection, profiles) {
-  const lines = [
-    '',
-    '╭─ Wizer ─────────────────────────────────────╮',
-    '│ Welcome back. What are we working on?       │',
-    '╰─────────────────────────────────────────────╯'
-  ];
-  if (detection.brownfield) {
-    lines.push('');
-    lines.push('I see this repo already has code. I can ask Pepper and Peggy to baseline it before we plan.');
-    lines.push('  → /wize-document-project');
+  const lines = [];
+  const profileCodes = new Set(profiles.map(p => p.code));
+
+  if (detection && detection.brownfield) {
+    lines.push('Brownfield detected — baseline ready.');
+  }
+
+  if (profileCodes.has('security-overlay')) {
+    lines.push('Security pentest available (/wize-sec-recon).');
   }
-  lines.push('');
-  lines.push('When ready, name the next step:');
-  lines.push('  → /wize-product-brief          (Pepper)');
-  lines.push('  → /wize-create-prd             (Maria Hill, if brief exists)');
-  lines.push('  → /wize-create-architecture    (Tony, if PRD exists)');
-  lines.push('  → /wize-quick-dev              (Shuri, for small fixes)');
-  if (profiles.find(p => p.code === 'web-overlay')) lines.push('  → /wize-web-scaffold           (overlay)');
-  if (profiles.find(p => p.code === 'app-overlay')) lines.push('  → /wize-app-scaffold           (overlay)');
-  if (profiles.find(p => p.code === 'security-overlay')) lines.push('  → /wize-sec-pentest         (overlay)');
+
+  lines.push('→ /wize');
   return lines.join('\n');
 }
 

package/tools/installer/render-shared.js

@@ -12,6 +12,32 @@ const fs = require('node:fs');
 const path = require('node:path');
 const { walkAgents, walkWorkflows, walkSkills } = require('./validators/walk.js');
 
+// Shared block-scalar reader used by both readYamlField (agent.yaml) and
+// readFrontmatter (skill.md / workflow.md). Returns { value, nextIndex }.
+function readBlockScalar(lines, startIndex, folded) {
+  const collected = [];
+  let baseIndent = null;
+  let i = startIndex;
+  for (; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim() === '') { collected.push(''); continue; }
+    const indent = line.match(/^(\s*)/)[1].length;
+    if (indent === 0) break; // dedent to a sibling top-level key ends the block
+    if (baseIndent === null) baseIndent = indent;
+    collected.push(line.slice(baseIndent));
+  }
+  while (collected.length && collected[collected.length - 1] === '') collected.pop();
+  if (folded) {
+    const value = collected.reduce((acc, ln, idx) => {
+      if (idx === 0) return ln;
+      if (ln === '' || collected[idx - 1] === '') return acc + '\n' + ln;
+      return acc + ' ' + ln;
+    }, '').trim();
+    return { value, nextIndex: i };
+  }
+  return { value: collected.join('\n').trim(), nextIndex: i };
+}
+
 function readYamlField(content, field) {
   const lines = content.split('\n');
   const keyRe = new RegExp('^' + field + ':\\s*(.*)$');
@@ -23,27 +49,7 @@ function readYamlField(content, field) {
     // Block scalar (| literal, > folded) with optional chomp/indent indicator.
     const block = inline.match(/^([|>])[+-]?\d*\s*$/);
     if (block) {
-      const folded = block[1] === '>';
-      const collected = [];
-      let baseIndent = null;
-      for (let j = i + 1; j < lines.length; j++) {
-        const line = lines[j];
-        if (line.trim() === '') { collected.push(''); continue; }
-        const indent = line.match(/^(\s*)/)[1].length;
-        if (indent === 0) break; // dedent to a sibling top-level key ends the block
-        if (baseIndent === null) baseIndent = indent;
-        collected.push(line.slice(baseIndent));
-      }
-      while (collected.length && collected[collected.length - 1] === '') collected.pop();
-      if (folded) {
-        // Folded: blank line -> newline, otherwise join lines with a space.
-        return collected.reduce((acc, ln, idx) => {
-          if (idx === 0) return ln;
-          if (ln === '' || collected[idx - 1] === '') return acc + '\n' + ln;
-          return acc + ' ' + ln;
-        }, '').trim();
-      }
-      return collected.join('\n').trim();
+      return readBlockScalar(lines, i + 1, block[1] === '>').value;
     }
 
     // Inline scalar: quoted or plain.
@@ -59,9 +65,25 @@ function readFrontmatter(content) {
   if (end === -1) return {};
   const lines = content.slice(3, end).split('\n');
   const out = {};
-  for (const line of lines) {
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
     const m = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*?)\s*$/);
-    if (m) out[m[1]] = m[2].replace(/^"|"$/g, '').replace(/^'|'$/g, '');
+    if (!m) continue;
+    const key = m[1];
+    const inline = m[2].trim();
+
+    // Block scalar (| literal, > folded) with optional chomp/indent indicator.
+    const block = inline.match(/^([|>])[+-]?\d*\s*$/);
+    if (block) {
+      const result = readBlockScalar(lines, i + 1, block[1] === '>');
+      out[key] = result.value;
+      i = result.nextIndex - 1; // -1 because the for loop will increment
+      continue;
+    }
+
+    // Inline scalar: quoted or plain.
+    const q = inline.match(/^"([^"]*)"$/) || inline.match(/^'([^']*)'$/);
+    out[key] = (q ? q[1] : inline).trim();
   }
   return out;
 }
@@ -154,7 +176,7 @@ function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
       code: fm.code,
       name: fm.name || fm.code,
       title: fm.phase || fm.gate || '',
-      description: `${fm.phase || fm.gate || 'workflow'}: ${fm.name || fm.code}`,
+      description: fm.description || `${fm.phase || fm.gate || 'workflow'}: ${fm.name || fm.code}`,
       body: bodyAfterFrontmatter(content),
       overlay: fm.overlay || null,
       owner: fm.owner || null,
@@ -175,7 +197,7 @@ function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
       code: fm.code,
       name: fm.name || fm.code,
       title: fm.module || '',
-      description: fm.module ? `${fm.module} skill: ${fm.name || fm.code}` : (fm.name || fm.code),
+      description: fm.description || (fm.module ? `${fm.module} skill: ${fm.name || fm.code}` : (fm.name || fm.code)),
       body: bodyAfterFrontmatter(content),
       overlay: fm.overlay || null,
       owner: fm.owner || null,
@@ -272,8 +294,8 @@ function renderAgentsMd(kitRoot, projectRoot, opts = {}) {
     'instructions and persistent memory — not background reading. Read project state before',
     'acting; write what you change back into `.wize/` so the next session inherits it.',
     '',
-    'Before editing, classify the demand via `/wize-help`: **Quick Dev** (small, predictable,',
-    '~≤1h, no new feature / architecture / UX / security) or **Full Lifecycle**. Never pick',
+    'Before editing, classify the demand via `/wize` (or `/wize-help`): **Quick Dev** (small, predictable,',
+    'trivially scoped, no new feature / architecture / UX / security) or **Full Lifecycle**. Never pick',
     'Quick Dev just to skip artifacts.',
     '',
     'When a skill fans out to subagents, match the model tier to the task: a lightweight tier',
@@ -288,7 +310,7 @@ function renderAgentsMd(kitRoot, projectRoot, opts = {}) {
     const optIn = a.code.startsWith('wize-sec-') ? ' _(security-overlay, opt-in)_' : '';
     lines.push(`- **${a.name}** (\`${a.code}\`)${optIn} — ${a.title}. ${clipOneLine(a.description, 180)}`);
   }
-  lines.push('', '## Where to start', '', 'Activate the orchestrator: `wize-orchestrator` (Wizer). Then ask `/wize-help`.', '');
+  lines.push('', '## Where to start', '', 'Activate the orchestrator: `/wize` (or `/wize-help`). Wizer will guide you.', '');
 
   if (opts.dryRun) return { written: ['[dry-run] AGENTS.md'], skipped: [] };
   fs.writeFileSync(file, lines.join('\n'), 'utf-8');

package/tools/installer/validators/run-all.js

@@ -13,7 +13,7 @@ const { walkAgents, walkWorkflows, walkSkills } = require('./walk.js');
 function checkAgent(file) {
   const content = fs.readFileSync(file, 'utf-8');
   const errs = [];
-  if (!/^code:\s+wize-/m.test(content)) errs.push('missing or invalid "code:" prefix');
+  if (!/^code:\s+wize(-|$)/m.test(content)) errs.push('missing or invalid "code:" prefix');
   if (!/^name:/m.test(content))         errs.push('missing "name:"');
   if (!/^title:/m.test(content))        errs.push('missing "title:"');
   if (!/^description:/m.test(content))  errs.push('missing "description:"');
@@ -24,9 +24,10 @@ function checkWorkflow(file) {
   const content = fs.readFileSync(file, 'utf-8');
   const errs = [];
   if (!/^---\s*$/m.test(content))    errs.push('missing YAML frontmatter');
-  if (!/^code:\s+wize-/m.test(content)) errs.push('missing or invalid "code:" prefix');
+  if (!/^code:\s+wize(-|$)/m.test(content)) errs.push('missing or invalid "code:" prefix');
   if (!/^name:/m.test(content))      errs.push('missing "name:"');
   if (!/^owner:/m.test(content) && !/^module:/m.test(content)) errs.push('missing "owner:" or "module:"');
+  if (!/^description:/m.test(content)) errs.push('missing "description:"');
   return errs;
 }