wize-dev-kit 0.15.0 → 0.16.0

package/tools/installer/render-shared.js

@@ -12,51 +12,11 @@ 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*(.*)$');
-  for (let i = 0; i < lines.length; i++) {
-    const m = lines[i].match(keyRe);
-    if (!m) continue;
-    const inline = m[1].trim();
-
-    // Block scalar (| literal, > folded) with optional chomp/indent indicator.
-    const block = inline.match(/^([|>])[+-]?\d*\s*$/);
-    if (block) {
-      return readBlockScalar(lines, i + 1, block[1] === '>').value;
-    }
-
-    // Inline scalar: quoted or plain.
-    const q = inline.match(/^"([^"]*)"$/) || inline.match(/^'([^']*)'$/);
-    return (q ? q[1] : inline).trim();
-  }
-  return null;
+  const re = new RegExp('^' + field + ':\\s*(?:"([^"]*)"|\'([^\']*)\'|(.*?))\\s*$', 'm');
+  const m = content.match(re);
+  if (!m) return null;
+  return (m[1] || m[2] || m[3] || '').trim();
 }
 
 function readFrontmatter(content) {
@@ -65,25 +25,9 @@ function readFrontmatter(content) {
   if (end === -1) return {};
   const lines = content.slice(3, end).split('\n');
   const out = {};
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
+  for (const line of lines) {
     const m = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):\s*(.*?)\s*$/);
-    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();
+    if (m) out[m[1]] = m[2].replace(/^"|"$/g, '').replace(/^'|'$/g, '');
   }
   return out;
 }
@@ -109,42 +53,6 @@ function ensureDir(dir) {
   fs.mkdirSync(dir, { recursive: true });
 }
 
-// Companion files (steps/, templates/, data/, *.csv, *-template.md,
-// customize.toml, research.template.md, etc.) that micro-file workflows
-// reference from their body. We must copy these alongside the SKILL.md so
-// the IDE can resolve paths like "./steps/step-01-init.md" at runtime.
-const SKIP_NAMES = new Set(['.DS_Store', 'Thumbs.db', 'node_modules', '.git']);
-const SKIP_FILES = new Set([
-  'skill.md', 'workflow.md', 'agent.yaml', 'persona.md',
-  'package.json', 'package-lock.json'
-]);
-
-function isCompanion(entry) {
-  if (entry.name.startsWith('.')) return false;
-  if (SKIP_NAMES.has(entry.name)) return false;
-  if (SKIP_FILES.has(entry.name)) return false;
-  if (entry.name.endsWith('.test.js')) return false;
-  return true;
-}
-
-function copyCompanionFiles(srcDir, destDir, written, relPrefix = '') {
-  if (!srcDir || !fs.existsSync(srcDir)) return;
-  for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
-    if (!isCompanion(entry)) continue;
-    const s = path.join(srcDir, entry.name);
-    const d = path.join(destDir, entry.name);
-    const rel = relPrefix ? `${relPrefix}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) {
-      ensureDir(d);
-      copyCompanionFiles(s, d, written, rel);
-    } else if (entry.isFile()) {
-      ensureDir(path.dirname(d));
-      fs.copyFileSync(s, d);
-      written.push(rel);
-    }
-  }
-}
-
 // Walks the kit and returns a flat array of "assets" the adapters can render.
 // Each asset has: { kind: 'agent'|'workflow'|'skill', code, name, title, description, body, overlay }
 function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
@@ -161,7 +69,7 @@ function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
     if (!code || !name) continue;
     const personaPath = path.join(dir, 'persona.md');
     const persona = fs.existsSync(personaPath) ? fs.readFileSync(personaPath, 'utf-8') : '';
-    out.push({ kind: 'agent', code, name, title, description, body: persona || description, overlay: null, srcDir: dir });
+    out.push({ kind: 'agent', code, name, title, description, body: persona || description, overlay: null });
   }
 
   for (const wfPath of walkWorkflows(kitRoot)) {
@@ -170,18 +78,14 @@ function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
     if (!fm.code) continue;
     if (fm.overlay === 'web' && !profSet.has('web-overlay')) continue;
     if (fm.overlay === 'app' && !profSet.has('app-overlay')) continue;
-    if (fm.overlay === 'security' && !profSet.has('security-overlay')) continue;
     out.push({
       kind: 'workflow',
       code: fm.code,
       name: fm.name || fm.code,
       title: fm.phase || fm.gate || '',
-      description: fm.description || `${fm.phase || fm.gate || 'workflow'}: ${fm.name || fm.code}`,
+      description: `${fm.phase || fm.gate || 'workflow'}: ${fm.name || fm.code}`,
       body: bodyAfterFrontmatter(content),
-      overlay: fm.overlay || null,
-      owner: fm.owner || null,
-      subtask: fm.subtask === 'true',
-      srcDir: path.dirname(wfPath)
+      overlay: fm.overlay || null
     });
   }
 
@@ -189,20 +93,14 @@ function collectAssets(kitRoot, { profiles = ['core'] } = {}) {
     const content = fs.readFileSync(skPath, 'utf-8');
     const fm = readFrontmatter(content);
     if (!fm.code) continue;
-    if (fm.overlay === 'web' && !profSet.has('web-overlay')) continue;
-    if (fm.overlay === 'app' && !profSet.has('app-overlay')) continue;
-    if (fm.overlay === 'security' && !profSet.has('security-overlay')) continue;
     out.push({
       kind: 'skill',
       code: fm.code,
       name: fm.name || fm.code,
       title: fm.module || '',
-      description: fm.description || (fm.module ? `${fm.module} skill: ${fm.name || fm.code}` : (fm.name || fm.code)),
+      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,
-      subtask: fm.subtask === 'true',
-      srcDir: path.dirname(skPath)
+      overlay: null
     });
   }
 
@@ -242,10 +140,6 @@ function renderAnthropicSkills(kitRoot, targetDir, opts = {}) {
       ensureDir(skillDir);
       fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content, 'utf-8');
       written.push(`${a.code}/SKILL.md`);
-      // Copy companion files (steps/, templates/, data/, *.csv, customize.toml,
-      // *-template.md, research.template.md, etc.) so micro-file workflows can
-      // resolve relative paths from inside the SKILL body.
-      copyCompanionFiles(a.srcDir, skillDir, written, a.code);
     }
   }
   return { written, skipped: [] };
@@ -253,30 +147,9 @@ function renderAnthropicSkills(kitRoot, targetDir, opts = {}) {
 
 // Convenience emitter for a root-level AGENTS.md — read by Codex, Cursor,
 // Windsurf and Antigravity as a baseline pointer to the kit's deeper docs.
-// Canonical roster order so AGENTS.md is deterministic regardless of the
-// filesystem walk order. Codes not listed sort last, alphabetically.
-const AGENT_ORDER = [
-  'wize-orchestrator',
-  'wize-agent-analyst',
-  'wize-agent-tech-writer',
-  'wize-agent-pm',
-  'wize-agent-ux-designer',
-  'wize-agent-solution-strategist',
-  'wize-agent-architect',
-  'wize-agent-test-architect',
-  'wize-agent-dev',
-  'wize-sec-red-teamer'
-];
-
 function renderAgentsMd(kitRoot, projectRoot, opts = {}) {
   const assets = collectAssets(kitRoot, opts);
-  const rank = (code) => {
-    const i = AGENT_ORDER.indexOf(code);
-    return i === -1 ? AGENT_ORDER.length : i;
-  };
-  const agents = assets
-    .filter(a => a.kind === 'agent')
-    .sort((a, b) => rank(a.code) - rank(b.code) || a.code.localeCompare(b.code));
+  const agents = assets.filter(a => a.kind === 'agent');
   const file = path.join(projectRoot, 'AGENTS.md');
   if (fs.existsSync(file) && !opts.overwrite) {
     return { written: [], skipped: ['AGENTS.md (already present; not overwritten)'] };
@@ -286,31 +159,15 @@ function renderAgentsMd(kitRoot, projectRoot, opts = {}) {
     '',
     'This repo is wired with the [`wize-dev-kit`](https://www.npmjs.com/package/wize-dev-kit).',
     'Detailed artifacts live under `.wize/`. The agents below are activated through your AI IDE',
-    'using slash commands (Claude Code, Codex, Cursor, Windsurf, Antigravity, Hermes all read this file).',
-    '',
-    '## Operating context',
-    '',
-    'Treat `.wize/`, this `AGENTS.md`, and the installed `wize-*` skills as your operating',
-    '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` (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',
-    'for mechanical work (reads, greps, formatting, short summaries), the standard tier for',
-    'implementation and review, a high-capability tier only for architecture, critical',
-    'decisions, or final adversarial review.',
+    'using slash commands (Claude Code, Codex, Cursor, Windsurf, Antigravity all read this file).',
     '',
     '## Roster',
     ''
   ];
   for (const a of agents) {
-    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(`- **${a.name}** (\`${a.code}\`) — ${a.title}. ${clipOneLine(a.description, 180)}`);
   }
-  lines.push('', '## Where to start', '', 'Activate the orchestrator: `/wize` (or `/wize-help`). Wizer will guide you.', '');
+  lines.push('', '## Where to start', '', 'Activate the orchestrator: `wize-orchestrator` (Wizer). Then ask `/wize-help`.', '');
 
   if (opts.dryRun) return { written: ['[dry-run] AGENTS.md'], skipped: [] };
   fs.writeFileSync(file, lines.join('\n'), 'utf-8');
@@ -321,7 +178,6 @@ module.exports = {
   collectAssets,
   renderAnthropicSkills,
   renderAgentsMd,
-  copyCompanionFiles,
   // Re-exports for adapter authors who need to roll their own format:
   readFrontmatter,
   bodyAfterFrontmatter,

package/tools/installer/setup-helpers.js

@@ -24,7 +24,6 @@ const GITIGNORE_BODY = [
   '.agent/skills/wize-*',
   '.agents/skills/wize-*',
   '.kimi/skills/wize-*',
-  '.hermes/skills/wize-*',
   '.cursor/rules/wize-*.mdc',
   '.windsurf/rules/wize-*.md',
   '.continue/prompts/wize-*.prompt',

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,10 +24,9 @@ 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;
 }