devlyn-cli 3.3.1 → 4.0.1

package/bin/devlyn.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+const crypto = require('crypto');
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -14,35 +15,57 @@ const { updateInstructions, InstructionError } = require('./instructions');
 // The devlyn skill bundle installed into every skill-capable agent's loader
 // directory. Single source of truth so codex/omp/pi stay in lockstep — adding a
 // skill here installs it everywhere.
-const DEVLYN_CORE_SKILLS = ['devlyn:resolve', 'devlyn:ideate', 'devlyn:design-ui', 'devlyn:engines', 'devlyn:queue', '_shared'];
-const DEVLYN_SKILL_DIR_STAMP = '__DEVLYN_SKILL_DIR__';
+const DEVLYN_CORE_SKILLS = ['devlyn-resolve', 'devlyn-ideate', 'devlyn-design-ui', 'devlyn-engines', 'devlyn-queue', '_shared'];
+// 4.0.0 renamed the colon-named skills to the Agent Skills standard (`[a-z0-9-]`, name ==
+// folder): Git for Windows cannot check out a folder with ':' in its name. Installs from 3.x
+// and earlier keep the old folder under either spelling (':' or npm's U+F03A extraction
+// alias). Both are removed, and an optional skill that was installed is installed again
+// under its new name in the same place.
+const RENAMED_SKILLS = {
+  'devlyn:resolve': 'devlyn-resolve',
+  'devlyn:ideate': 'devlyn-ideate',
+  'devlyn:design-ui': 'devlyn-design-ui',
+  'devlyn:engines': 'devlyn-engines',
+  'devlyn:queue': 'devlyn-queue',
+  'devlyn:pencil-pull': 'devlyn-pencil-pull',
+  'devlyn:pencil-push': 'devlyn-pencil-push',
+  'devlyn:reap': 'devlyn-reap',
+};
 const DEVLYN_INSTALL_MARKER = '.devlyn-install.json';
 
-function logicalSkillName(name) {
-  return name.replace(/\uF03A/g, ':');
+// Every spelling a colon name can have on disk: its own and npm's U+F03A extraction alias.
+function legacySkillPaths(root, name) {
+  return [...new Set([name, name.replace(/:/g, '\uF03A')])].map((spelling) => path.join(root, spelling));
 }
 
-function physicalSkillName(name) {
-  return process.platform === 'win32' ? name.replace(/:/g, '\uF03A') : name;
-}
+// SKILL.md of the pencil skills 0.6.0-0.7.1 installed under today's names, without the
+// frontmatter the standard requires, hashed with LF line endings (a Windows checkout may hold
+// CRLF). 3.x deleted these copies; 4.0 replaces them.
+const PRE_STANDARD_SKILL_MD_SHA256 = new Set([
+  'dfdd3d19ca676558bfa2bb3ce398181b0a081ab88d1feaf69c54c706a9671631', // devlyn-pencil-pull
+  '5f2e8b29609cbb2af72941579823bec598265ebf29cd3a375d6aa47d95b74354', // devlyn-pencil-push
+]);
 
-function skillPath(root, name) {
-  name = logicalSkillName(name);
-  const aliases = [...new Set([name, name.replace(/:/g, '\uF03A')])];
-  const entries = fs.existsSync(root) ? fs.readdirSync(root) : [];
-  const found = aliases.filter((alias) => entries.includes(alias));
-  if (found.length > 1) throw new Error(`Ambiguous skill aliases in ${root}: ${found.join(', ')}`);
-  return path.join(root, found[0] || physicalSkillName(name));
-}
+// Skills devlyn-cli shipped and later deleted without listing them, by SHA-256 of their only
+// file, SKILL.md (LF endings): a user's own folder of the same name is never removed.
+const RETIRED_SKILL_MD_SHA256 = {
+  // 0.2.0-1.15.0; deleted in iter-0034, it still routes agents to retired commands.
+  'workflow-routing': new Set([
+    '7fec2bb20d808a873a975d64a6223e404bc5b328c800760bb77257ae6b2f467a',
+    '8bfdaeff2ce48d5a79b5653de3bbe0d56a61a7fd750ed3ad11149fec5a502ecf',
+  ]),
+};
 
-function preflightSkillDirs(source, target, names) {
-  for (const name of names) {
-    skillPath(source, name);
-    skillPath(target, name);
-  }
-  for (const relative of DEPRECATED_DIRS) {
-    skillPath(target, path.basename(relative));
-  }
+// Whether `dir` is a real folder whose only file (dotfiles such as .DS_Store aside) is a SKILL.md
+// with an LF-normalized SHA-256 in `hashes`: an unedited copy devlyn-cli shipped, not something
+// the user added to or wrote.
+function isShippedCopy(dir, hashes) {
+  const skill = path.join(dir, 'SKILL.md');
+  return fs.lstatSync(dir, { throwIfNoEntry: false })?.isDirectory() === true
+    && fs.readdirSync(dir).filter((name) => !name.startsWith('.')).length === 1
+    && fs.lstatSync(skill, { throwIfNoEntry: false })?.isFile() === true
+    && hashes.has(crypto.createHash('sha256')
+      .update(fs.readFileSync(skill, 'utf8').replace(/\r\n/g, '\n')).digest('hex'));
 }
 
 // Cross-agent shared skills directory read by BOTH oh-my-pi and Pi. Verified
@@ -134,21 +157,17 @@ const DEPRECATED_DIRS = [
   // v0.7.x rename: devlyn-* → devlyn:*
   'skills/devlyn-clean',
   'skills/devlyn-design-system',
-  'skills/devlyn-design-ui',
   'skills/devlyn-discover-product',
   'skills/devlyn-evaluate',
   'skills/devlyn-feature-spec',
   'skills/devlyn-implement-ui',
   'skills/devlyn-product-spec',
   'skills/devlyn-recommend-features',
-  'skills/devlyn-resolve',
   'skills/devlyn-review',
   'skills/devlyn-team-design-ui',
   'skills/devlyn-team-resolve',
   'skills/devlyn-team-review',
   'skills/devlyn-update-docs',
-  'skills/devlyn-pencil-pull',
-  'skills/devlyn-pencil-push',
   // iter-0034 Phase 4 cutover: deleted user skills
   'skills/devlyn:auto-resolve',
   'skills/devlyn:browser-validate',
@@ -164,10 +183,6 @@ const DEPRECATED_DIRS = [
   'skills/devlyn:team-resolve',
   'skills/devlyn:team-review',
   'skills/devlyn:update-docs',
-  // iter-0034 Phase 4 cutover: moved to optional-skills/. Force-removed on
-  // upgrade so users only have them if they opt in via the interactive
-  // installer (matches the pencil-pull / pencil-push pattern).
-  'skills/devlyn:reap',
   // 0221 Session 1: standards skills moved to optional-skills/ (opt-in).
   'skills/code-health-standards',
   'skills/code-review-standards',
@@ -238,9 +253,9 @@ const OPTIONAL_ADDONS = [
   { name: 'polar-billing-setup', desc: 'Polar usage-based / metered billing — correct setup + diagnose silent $0-billing failures', type: 'local' },
   { name: 'pyx-scan', desc: 'Check whether an AI agent skill is safe before installing', type: 'local' },
   { name: 'dokkit', desc: 'Document template filling for DOCX/HWPX — ingest, fill, review, export', type: 'local' },
-  { name: 'devlyn:pencil-pull', desc: 'Pull Pencil designs into code with exact visual fidelity', type: 'local' },
-  { name: 'devlyn:pencil-push', desc: 'Push codebase UI to Pencil canvas for design sync', type: 'local' },
-  { name: 'devlyn:reap', desc: 'Safely reap orphaned MCP / codex / Superset child processes left behind by long Claude sessions', type: 'local' },
+  { name: 'devlyn-pencil-pull', desc: 'Pull Pencil designs into code with exact visual fidelity', type: 'local' },
+  { name: 'devlyn-pencil-push', desc: 'Push codebase UI to Pencil canvas for design sync', type: 'local' },
+  { name: 'devlyn-reap', desc: 'Safely reap orphaned MCP / codex / Superset child processes left behind by long Claude sessions', type: 'local' },
   { name: 'code-health-standards', desc: 'Maintainability standards — dead code, dependencies, complexity, naming, hygiene', type: 'local' },
   { name: 'code-review-standards', desc: 'Severity framework and approval criteria for reviewing a change', type: 'local' },
   { name: 'root-cause-analysis', desc: 'Evidence-first why-chain debugging to the actionable root cause', type: 'local' },
@@ -255,7 +270,7 @@ const OPTIONAL_ADDONS = [
   // Note: the Codex integration uses the local `codex` CLI binary (not MCP).
   // Install the CLI separately per https://platform.openai.com/docs/codex — the
   // pair/risk-probe routes fail closed when Codex is required but unavailable.
-  { name: 'playwright', desc: 'Playwright MCP for browser testing — powers /devlyn:resolve BUILD_GATE browser tier', type: 'mcp', command: 'npx -y @playwright/mcp@latest' },
+  { name: 'playwright', desc: 'Playwright MCP for browser testing — powers /devlyn-resolve BUILD_GATE browser tier', type: 'mcp', command: 'npx -y @playwright/mcp@latest' },
 ];
 
 function log(msg, color = 'reset') {
@@ -349,8 +364,8 @@ function listContents() {
 
 function cleanupDeprecated(targetDir) {
   let removed = 0;
-  const deprecated = DEPRECATED_DIRS.map((relPath) =>
-    [relPath, skillPath(path.join(targetDir, 'skills'), path.basename(relPath))]);
+  const deprecated = DEPRECATED_DIRS.flatMap((relPath) =>
+    legacySkillPaths(path.join(targetDir, 'skills'), path.basename(relPath)).map((fullPath) => [relPath, fullPath]));
   for (const relPath of DEPRECATED_FILES) {
     const fullPath = path.join(targetDir, relPath);
     if (fs.existsSync(fullPath)) {
@@ -366,22 +381,46 @@ function cleanupDeprecated(targetDir) {
       removed++;
     }
   }
+  for (const [name, hashes] of Object.entries(RETIRED_SKILL_MD_SHA256)) {
+    const fullPath = path.join(targetDir, 'skills', name);
+    if (isShippedCopy(fullPath, hashes)) {
+      fs.rmSync(fullPath, { recursive: true });
+      log(`  ✕ skills/${name}/ (removed)`, 'dim');
+      removed++;
+    }
+  }
   return removed;
 }
 
+// Remove every old spelling of the renamed skills in `skillsDir`, after the new core skills
+// are in place. An optional skill found under an old spelling is installed under its new name
+// before the old copy goes, so an interrupted migration never loses it. An unedited 0.6.0-0.7.1
+// copy is refreshed in place. Any other folder under a 4.0 name is the user's own; `-y` leaves it.
+function retireRenamedSkills(skillsDir) {
+  const optional = new Set(OPTIONAL_ADDONS.filter((addon) => addon.type === 'local').map((addon) => addon.name));
+  for (const [oldName, newName] of Object.entries(RENAMED_SKILLS)) {
+    const found = legacySkillPaths(skillsDir, oldName).filter((fullPath) => fs.existsSync(fullPath));
+    if (found.length > 0 && optional.has(newName)) installOptionalSkillInto(skillsDir, newName);
+    else if (isShippedCopy(path.join(skillsDir, newName), PRE_STANDARD_SKILL_MD_SHA256)) refreshPreStandardCopy(skillsDir, newName);
+    for (const fullPath of found) {
+      fs.rmSync(fullPath, { recursive: true, force: true });
+      log(`  ✕ ${path.basename(fullPath)}/ (renamed to ${newName})`, 'dim');
+    }
+  }
+}
+
 function copyRecursive(src, dest, baseDir) {
   const stats = fs.statSync(src);
 
   if (stats.isDirectory()) {
     // Never install dev workspaces, even when running from source repo.
-    if (UNSHIPPED_SKILL_DIRS.has(logicalSkillName(path.basename(src)))) return;
+    if (UNSHIPPED_SKILL_DIRS.has(path.basename(src))) return;
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
 
     for (const item of fs.readdirSync(src)) {
-      const name = src === path.join(CONFIG_SOURCE, 'skills') ? physicalSkillName(logicalSkillName(item)) : item;
-      copyRecursive(path.join(src, item), path.join(dest, name), baseDir);
+      copyRecursive(path.join(src, item), path.join(dest, item), baseDir);
     }
   } else {
     const destDir = path.dirname(dest);
@@ -407,8 +446,8 @@ function assertCompleteSkillInstall(sourceSkillsDir, skillsDir, skillNames) {
     return fs.statSync(dest).isFile();
   }
   const missing = skillNames.filter((name) => {
-    const src = skillPath(sourceSkillsDir, name);
-    const dest = skillPath(skillsDir, name);
+    const src = path.join(sourceSkillsDir, name);
+    const dest = path.join(skillsDir, name);
     return !complete(src, dest) || (name !== '_shared' && !fs.existsSync(path.join(src, 'SKILL.md')));
   });
   if (missing.length > 0) {
@@ -436,45 +475,12 @@ function writeInstallMarker(skillsDir) {
   }
 }
 
-function shellDoubleQuoteDefault(value) {
-  if (value.includes('\n')) {
-    throw new Error(`Cannot stamp skill path with newline: ${value}`);
-  }
-  return value.replace(/[\\$"`}]/g, '\\$&');
-}
-
-function stampInstalledSkillDir(rootDir, skillDir) {
-  // Stamp ONLY the assignment-default occurrence. The sentinel comparison
-  // literal on the guard line must stay intact: stamping it makes the guard
-  // compare the stamped default to itself and false-positive
-  // BLOCKED:shared-dir-unresolved on every codex/omp run that executes the
-  // block (CLAUDE_SKILL_DIR unset) — iter-0040 R3 latent finding.
-  const assignmentStamp = '${CLAUDE_SKILL_DIR:-' + DEVLYN_SKILL_DIR_STAMP + '}';
-  const stampedAssignment = '${CLAUDE_SKILL_DIR:-' + shellDoubleQuoteDefault(skillDir) + '}';
-
-  function visit(current) {
-    const stats = fs.statSync(current);
-    if (stats.isDirectory()) {
-      for (const item of fs.readdirSync(current)) {
-        visit(path.join(current, item));
-      }
-      return;
-    }
-    if (path.extname(current) !== '.md') return;
-
-    const content = fs.readFileSync(current, 'utf8');
-    if (!content.includes(assignmentStamp)) return;
-    fs.writeFileSync(current, content.split(assignmentStamp).join(stampedAssignment));
-  }
-
-  visit(rootDir);
-}
-
 // Dev artifacts that live under config/skills/ but must never ship or install.
 // Mirrors the `!` exclusions in package.json files[].
 const UNSHIPPED_SKILL_DIRS = new Set([
   'devlyn:auto-resolve-workspace',
   'devlyn:ideate-workspace',
+  'devlyn-ideate-workspace',
   'preflight-workspace',
   'roadmap-archival-workspace',
 ]);
@@ -488,12 +494,11 @@ const UNSHIPPED_SKILL_DIRS = new Set([
 // no counterpart in source. Dev workspaces are skipped entirely.
 function cleanManagedSkillDirs(sourceSkillsDir, targetSkillsDir) {
   if (!fs.existsSync(sourceSkillsDir) || !fs.existsSync(targetSkillsDir)) return 0;
-  preflightSkillDirs(sourceSkillsDir, targetSkillsDir, fs.readdirSync(sourceSkillsDir));
   let cleaned = 0;
   for (const entry of fs.readdirSync(sourceSkillsDir, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
-    if (UNSHIPPED_SKILL_DIRS.has(logicalSkillName(entry.name))) continue;
-    const targetPath = skillPath(targetSkillsDir, entry.name);
+    if (UNSHIPPED_SKILL_DIRS.has(entry.name)) continue;
+    const targetPath = path.join(targetSkillsDir, entry.name);
     if (fs.existsSync(targetPath)) {
       fs.rmSync(targetPath, { recursive: true, force: true });
       cleaned++;
@@ -596,11 +601,10 @@ function multiSelect(items, preselectedIndices = []) {
 }
 
 function installLocalSkill(skillName) {
-  const src = skillPath(OPTIONAL_SKILLS_SOURCE, skillName);
+  const src = path.join(OPTIONAL_SKILLS_SOURCE, skillName);
   const targetDir = getTargetDir();
   const targets = new Set([path.join(targetDir, 'skills'), ...Object.values(CLI_TARGETS)
     .map((cli) => cli.skillsDir).filter((dir) => dir && fs.existsSync(dir))]);
-  for (const target of targets) skillPath(target, skillName);
 
   if (!fs.existsSync(src)) {
     log(`   ⚠️  Skill "${skillName}" not found`, 'yellow');
@@ -615,16 +619,37 @@ function installLocalSkill(skillName) {
   // create an agent install just because someone opted into a Claude-side skill.
   // De-dup by directory: omp and Pi share ~/.agents/skills, so the mirror runs
   // once per unique destination.
-  for (const target of targets) {
-    fs.rmSync(skillPath(target, skillName), { recursive: true, force: true });
-    const dest = path.join(target, physicalSkillName(skillName));
-    copyRecursive(src, dest, target);
-    stampInstalledSkillDir(dest, dest);
-    assertCompleteSkillInstall(OPTIONAL_SKILLS_SOURCE, target, [skillName]);
-  }
+  for (const target of targets) installOptionalSkillInto(target, skillName);
   return true;
 }
 
+// One optional skill into one skill-loader directory, replacing any older copy of it. A
+// copy under its name before the 4.0.0 rename goes only once the new one is complete.
+function installOptionalSkillInto(target, skillName) {
+  const dest = path.join(target, skillName);
+  fs.rmSync(dest, { recursive: true, force: true });
+  copyRecursive(path.join(OPTIONAL_SKILLS_SOURCE, skillName), dest, target);
+  assertCompleteSkillInstall(OPTIONAL_SKILLS_SOURCE, target, [skillName]);
+  const oldName = Object.keys(RENAMED_SKILLS).find((name) => RENAMED_SKILLS[name] === skillName);
+  for (const fullPath of oldName ? legacySkillPaths(target, oldName) : []) {
+    fs.rmSync(fullPath, { recursive: true, force: true });
+  }
+}
+
+// A 0.6.0-0.7.1 copy is one SKILL.md, the file that identifies it. Renaming the new one over it is
+// atomic, so an interrupted run leaves the old copy, which the retry finds again, or the new.
+function refreshPreStandardCopy(target, skillName) {
+  const skill = path.join(target, skillName, 'SKILL.md');
+  const staged = `${skill}.${process.pid}.tmp`;
+  try {
+    fs.copyFileSync(path.join(OPTIONAL_SKILLS_SOURCE, skillName, 'SKILL.md'), staged);
+    fs.renameSync(staged, skill);
+  } finally {
+    fs.rmSync(staged, { force: true });
+  }
+  assertCompleteSkillInstall(OPTIONAL_SKILLS_SOURCE, target, [skillName]);
+}
+
 function installMcpServer(name, command) {
   try {
     log(`\n🔌 Installing MCP server: ${name}...`, 'cyan');
@@ -681,7 +706,6 @@ function installSkillsForCLI(cliKey) {
     fs.mkdirSync(cli.skillsDir, { recursive: true });
   }
   clearInstallMarker(cli.skillsDir);
-  preflightSkillDirs(sourceSkillsDir, cli.skillsDir, cli.skillsToInstall);
 
   const removed = cleanupDeprecated(path.dirname(cli.skillsDir));
   if (removed > 0) {
@@ -690,21 +714,20 @@ function installSkillsForCLI(cliKey) {
 
   let copied = 0;
   for (const skillName of cli.skillsToInstall) {
-    const src = skillPath(sourceSkillsDir, skillName);
-    const previous = skillPath(cli.skillsDir, skillName);
-    const dest = path.join(cli.skillsDir, physicalSkillName(skillName));
+    const src = path.join(sourceSkillsDir, skillName);
+    const dest = path.join(cli.skillsDir, skillName);
     if (!fs.existsSync(src)) continue;
     // Full replace per cleanManagedSkillDirs semantics: stale files in the
     // installed mirror would otherwise persist forever.
-    if (fs.existsSync(previous)) {
-      fs.rmSync(previous, { recursive: true, force: true });
+    if (fs.existsSync(dest)) {
+      fs.rmSync(dest, { recursive: true, force: true });
     }
     copyRecursive(src, dest, cli.skillsDir);
-    stampInstalledSkillDir(dest, dest);
     copied++;
     log(`  → ${cli.skillsDir.replace(os.homedir(), '~')}/${skillName}`, 'dim');
   }
   assertCompleteSkillInstall(sourceSkillsDir, cli.skillsDir, cli.skillsToInstall);
+  retireRenamedSkills(cli.skillsDir);
   writeInstallMarker(cli.skillsDir);
   return copied;
 }
@@ -803,6 +826,10 @@ function installClaudeCore() {
   log('\n📁 Installing Claude Code config to .claude/', 'green');
   if (!fs.existsSync(skillsDir)) fs.mkdirSync(skillsDir, { recursive: true });
   clearInstallMarker(skillsDir);
+  const removed = cleanupDeprecated(targetDir);
+  if (removed > 0) {
+    log(`\n🧹 Cleaned up ${removed} deprecated file${removed > 1 ? 's' : ''}`, 'yellow');
+  }
   const refreshed = cleanManagedSkillDirs(
     path.join(CONFIG_SOURCE, 'skills'),
     skillsDir,
@@ -812,18 +839,9 @@ function installClaudeCore() {
   }
   copyRecursive(CONFIG_SOURCE, targetDir, targetDir);
   assertCompleteSkillInstall(path.join(CONFIG_SOURCE, 'skills'), skillsDir, DEVLYN_CORE_SKILLS);
-  for (const name of DEVLYN_CORE_SKILLS) {
-    const dest = skillPath(skillsDir, name);
-    stampInstalledSkillDir(dest, dest);
-  }
+  retireRenamedSkills(skillsDir);
   writeInstallMarker(skillsDir);
 
-  // Remove deprecated files from previous versions
-  const removed = cleanupDeprecated(targetDir);
-  if (removed > 0) {
-    log(`\n🧹 Cleaned up ${removed} deprecated file${removed > 1 ? 's' : ''}`, 'yellow');
-  }
-
   // Keep installer-managed pipeline state and install metadata out of git.
   const gitignorePath = path.join(process.cwd(), '.gitignore');
   const gitignoreEntries = ['.devlyn/', '.claude/skills/.devlyn-install.json'];

package/bin/instruction-templates.json

@@ -149,10 +149,13 @@
       "4bbcb7fefd5366ed4151ce588e8482b747bdd85a7ecf795862a1c243218a162f",
       "4c3c4295f7cb794d0466f93886bf89b316382feafec68606385eb6b4c36eebbc",
       "4c4ee4b0948bc84b130c39b9846a5317ec76a6e3a8d95281a78e740192081662",
+      "4cae665b0a714cd7b20b59ef356b53e21dec1cf4679458de2a23b5077bceafff",
+      "4d42f91b8ff88de40921f825ec3a9aeeba30e85c7442ea2f8876b7c68555c39c",
       "4d756bc5c6a7c7ca1589efc6c340c75fb389699fe14d114aa211a29921e7effe",
       "4dcba526b49c91411d98925a7f638d990acea0f904ba8f143f195f7f99f85e33",
       "4e114313a6fbf27b89bebe7847f9aebb4ca2c61d23d167997efd459fa091e602",
       "4f6bf3fa8b8b706d234a7d5a3dda34e52ce1fcba68770aadf606c1717543bd5a",
+      "50fe2edc6da214c0ae4bfce43d8d210f98ff15da2d2f9bca88269dab9a4ed179",
       "53a8f3196d2320ba46bf1299bfabb38dff495218bb47b35a43ac5072308f9deb",
       "54cdf7a05afb97642d06a0d8284f17d51fed5ce0fdcdac949655c47734802893",
       "55ff3f39ef7341cfb1e8b50271821d574eeddc455461d6df317caa9c5b55827f",
@@ -193,6 +196,7 @@
       "76517a747d47a3986b7181db4bbe5898ad3d6d82644ce39d8bf62edc998cecb9",
       "766c776b750cb84f084c49679fa377899693acf5f8d4e00751ca0fab97b4f030",
       "78690fc75b54ee634413fd0d5f6892692b2557e8838fbb8453f7bdd4b6519cc5",
+      "7a0d897737f705b0276b829df5b62fd9541e3897b872b2a2668f54e08b88dfff",
       "7aab816bfa43d73b4eb8bd9136242e8a4938f3610e7ad3c32e033b7ee3d28a1e",
       "7fde023e25658ff48c67b6708c5b6f383a6497a509946cb3bdc5da7d35e4f3f6",
       "8211bb3dcc9d7df40c393a4ef8e620526d84ded9faec25655cfa74801458515d",
@@ -200,6 +204,7 @@
       "8574b17a21f98a1cf558a7b88780eda07e8c39943168d0be49cbf4575edc23f1",
       "8694f41265b0f74734ce6801434fe255a4c2261501bcf13d37fe2e5b85a859e9",
       "870810ca9060fa45ef2eafd41c21282a21b9493cbec9632e2893556d07f3301f",
+      "890e3bdec4212b404e6c3675021922215d96705bb8def099a0d04ee65286585c",
       "892c26f1d54958622f5615734666f3b1aedb07e7a3ac225c416a5d3f1508312c",
       "8954f0209ecdac5a48f68c9ba5da95840ba745aabfb3751c6c216a06d809d1c9",
       "897d0d57a5ab67b082a3fbaf078ac3e9c724acb033b6df35b8959ae28c26bc93",
@@ -221,6 +226,7 @@
       "9e65019acb60433529160c929b840398fe6e5d72dcfd219cb79e69ba2d3cd5e9",
       "9f62c5b2a94e8b5e81528ccbdb6f78d147d14882108568b2cb3b7f85212694c0",
       "a02eb2d8d77553327fb77377dbfedeab059b2e68e0a33c469b9be54a5d55182b",
+      "a27ec7f5f0f0a2798e53695f20dc43fe28378d551fc060e2c772d0b522a336e5",
       "a3a15249968f64085b0cec8c0826688a4c3a1e4cf09b4879054baa086d5cbca1",
       "a4da26a46ab83815d8ca5d747c68a907ad67dad485adbc6c863b982ee23b307e",
       "a5d6ff585d696254d6727cd1e6d7f8825881f90210eff744265e211ced715ea3",
@@ -228,6 +234,7 @@
       "aafc680a7ac73e100f4a17d2c4070190e68563f78614c39f4c2f58f1e291d9a9",
       "ab7f6d08d95cf1c22b7ec6e2e113158b7f767b73d8dde04fd1c3b33788922c93",
       "ac432d9179f245fec0beaf4010355613dcd6d476d8c9268c9cd430c98e73ff35",
+      "af3a498714fecb29ebdc1e43e5cc0425efaf1c290130e6913cabd75fe4c9cc67",
       "af77f01317665c50815eb3cfefe481519efcc9c8b81bac06fc110abf723c7868",
       "b3921b2317558010f99625aff30f3ed7a7a0dd4f37c586a6c4f9e1001e100134",
       "b3ac898e73c5b7923c1050bdbc36144dc6f4ad8bd9b83c8515394c418ef447ed",
@@ -266,12 +273,14 @@
       "d189a2002b4ef0e858acb734c4ed14f6af6f0b7bb250b178f65d439369a9149a",
       "d41692aa7577bbd85144fe73d111947f98e1304f4aceb891d712daa5907d550d",
       "d486a0b267c9425bde2cba737d802d2412a9b4b4b339e925500c1643327d2a3d",
+      "d5d8d02a1fb53cd28ed1c33e7184067b76defbfcc6cab9498b365dee35579013",
       "d75bdfc9cf08cfcb46214f69dac4f20b1a0a30b86d91127007fe587de9eaaeb0",
       "d768a149b5842e0d50eda941872188c8b29bcfb4b1aa0f4190fd4299f237fce0",
       "d8c50cb04441e6b568236bc6cd494b4de296dfc7e8b33cf96e7aeb94612df3b8",
       "da019f3edfb762b9216016a3ea9cf7211b2ba698a55ddda5cec2e478218b0288",
       "ddb200267b43942de3c061b449d08cc3f73441258b74816cfe13da091377b428",
       "dff43f9976c68267baf13f6a460f24af8e76be233c8440ac4684dc664106deae",
+      "e05f671dbf45aef8e7e4211195d46be8554c188d8df8899093359c414ffef2fe",
       "e237f12ed08800ccc4c6eb4ae57cdd59d61198711f6a3b02dcb668aa08fddb93",
       "e289dbab99dadb30d8315b32b8243154148c82955f238936bce4c1fe1c3ae525",
       "e2bac40f3ff0b39726f95caaa9b19aa3b21596f165ac7a9dc68ebf42681d58cb",
@@ -328,6 +337,7 @@
       "07d5c3147813efd7b5cf262709d4ee1643f962e5442f1f6e0f374d12d8d8c346",
       "07ec9e6c76821368b71110413acf43edd6e3c91b93e380eebed8f363a1915c7a",
       "080051ed34915b572971d9fc734b95ba7a7984f6e799a7286055d41a7aeaa3b6",
+      "0845abb4d59bce13c33c80b3292ba829bace0abe26d67a100a3bbc07e5db2b7d",
       "086b65c51d3342970968f4c3c6554a605b8740ed82809d26587cbd08f87d19f8",
       "0ab05e7ec571a8c899901514ab0655622817e8a77254ec2ec763fd78dad7f5bd",
       "0b45db686d97f33be4dc2b091ed259de534c2e3f97f8787574e722d2e86a0c1d",
@@ -367,6 +377,7 @@
       "18b3b8a84421d45d2f1cfd2d3bc936bb1635eb9fb426587ffb8b10ab224f5562",
       "18d96415b31677a8efe1d8e5d3246c62456fdee9f6371e8bc7817de6c062eb50",
       "1a7c6046a588a2608c146e5cb4403d943ef1d70f3779be1920a245442b48d7af",
+      "1af26e8d5dc8268e6372c1f2429aa2531a5780ae1956530a5b2978451121b4eb",
       "1b0c98cba21a4d616442124ed1e29259006398777a40fac41ba6b1894727c31f",
       "1c12577abd7db4345386fc7f24148dcbf6dabfe2ac89de3089fd27cca797aa0c",
       "1c14e388ba39b4953aa51b2b73a92d287027f6849e25ee8725d9e3ea51f78fa1",
@@ -401,6 +412,7 @@
       "2712e0f66046a30d80b9127688c67c73e809521dddedef1c10fad373d9a22114",
       "278bed8b8219c30412f09523678c050173875c14aa8545062e718669a4e76ee8",
       "27fe72a818b59177a7e692df7b02048eb7b8dd3b34e6e5a7717f2898df66ea00",
+      "284c050b55f96ae3c30d7f006aedd815f6b9601ceab010d569bc8622ee389fc3",
       "287fa116a8235756a8b0e28caa951a9ad981667443434e13dbfde3c23f1590e6",
       "28c5b42a58dca1a093576c8c35369c346caaf3963e14a4702ab3330d0d93e4d4",
       "2939f7a22fd12f3ca3fdd0a08fc52535cf25dae38b9b445aceed09dc331fc1de",
@@ -444,6 +456,7 @@
       "3ab5f6021b62f21624e3eed505cc6849c66972d01ac67337533cff0e81dc9dc8",
       "3afe3870751373b6059ebddfb6c179ab70b7a1f3a9299555ecf5ea47c2970422",
       "3b5bf36be5ad797443dc5c1c407684c6f86b28894ca9a975a3fb5c18b3066fbb",
+      "3ba1747fbe0662a0aa9c42e6e442748f013a8e90febc330e2854ab9ad841dd77",
       "3cfc73fecd13c54fd400f5b04b2c4113cc776c102f6f09eaa401252276818e17",
       "3d321af4f48efc92735cc8772cf092f15789ac63e1e20f857ba20c0532453eac",
       "3def30362c96b6238021ab82e6f2ebd2974005ca94a84008f43528aaa7eb435f",
@@ -452,6 +465,7 @@
       "3ed5bcfca2cccfb1da4c181b27f9f44b6e53bd9c47c3b12990dd2e0c0ea51c32",
       "3ee9206330fd3a17b04c5a5d136b92c2abf4792831c3c706bca463db3668fbcc",
       "3ef2dde760ee9b50380364f83f368268a7c7a91cbdda6e0f629ebb09258cffaf",
+      "40464d8ac0f0395c447e7e502f262d5b05398716259b109e9ee7929fa1fa0105",
       "40cc672b94e87300a3b317348d99f4c939e38316b5b9aa7f81e95f2ccf848f10",
       "40fc22e1faeaa5a3be482334a312717b259f384e991c70e962ebef12d16120e7",
       "41323b1c12be256f604edf8c49ff505acbaa75b6a1b938b76286d5eebec1ce95",
@@ -475,6 +489,7 @@
       "477c7b699d1d2f66b63f04b30c3f78ddb4208b6346af58ed3dfa48d0568191cf",
       "47bac4155f4e8f3d8e9eedce9dc7fc8039d74bc18c23213979fbe55e786d71a1",
       "480420a6bcf31ae06cf1d4fcf34c24d949be485d2e13c2827b54331bec129053",
+      "4846658fe0742e27b3e2fccbbf222dbb4b23f47b5a31792249fc818e4ab4a659",
       "484dc70c61110ccc7f4ba15e1a3e010b6653920e1bd852b9de61625942f7b056",
       "485f3e37ba8a27b5027fd887f7baeea98a9099c6c7421d0e67e848d99905dc54",
       "4923c02dff4a34a20d2f104ec3b17311cf269330932b7cf29addb2f4369dd23c",
@@ -494,6 +509,7 @@
       "4dda6aecfc27e1a2889a30e12310abdc986d59cb8a7034ee9da3ee43c274dbf6",
       "4e9eb8208ccd7fc7ec25010de2d9fa3df043452f3fa808ec520e283b7ebfa156",
       "500e680bebe35b368080d6a1f6d39183323f519612fc9a776509ed0a2effcaf7",
+      "50bdeff1ac1044668a9692a076ff3bb504a42fdcb5abc6b41ccc4f05d57e9acd",
       "5111747b387a61c55834df35d588156d2ef1e72b5530f4c33453754e4d35fcf1",
       "5111bcf0edbbdb07d24a854086303f0f76a489fae171e7e441c1ec5dd62dd109",
       "51ac33809c5f2a830a22d1f67f0f38f3b1e26acb47673fb3f691deb93d7e42b4",
@@ -522,6 +538,7 @@
       "5b29b4f80abac3c4f6748a16f38b3bb72c61a639f65c845d0569a87f8f8a0cf0",
       "5b79e4d8b7b75485b9be3341ec0d49ef4754c31d527bfb170d5cec1af92539e8",
       "5b82f9020d952e89ccf8803bce90dd5b9c38b39fa59a629349c9d15cc14c9597",
+      "5d1183e08f92cb76c9fb41131742771101daebd65199b32050818a554e1ca185",
       "5d56b35a8b69aabc401bb42cf93f38d0eebcb1219f3a8a032e124c45d4e4b5d8",
       "5dec4f3f015629b0c29c802b30a9e373c570fca85bb3e260c0dac9662d2685cd",
       "5dfd01e48b8b3eb9d6eec85d68624b2af0dd0eeb483307865ef88b0fc916bc97",
@@ -572,11 +589,13 @@
       "76fdf7a80d7948c3007f8c54d3d710e8855a4227cefc915b8b07c0cdb299ceb0",
       "77071010460d4aa8c89841d31a6f18600b804496de948710953dbd6f6fffc816",
       "7766a3152ac33c155748ef3a7c9f500a7927870409100f55e1070f32f3667c54",
+      "793c5984744c21dfd4e8720e6319d61ff51ed30117c633b410024aaffa5ba048",
       "7aaf7227bd67650944c709f4143b6b9161834d391e5cfd4aaeea105f5e840594",
       "7af6e9be693d906ba1f942430f46b288176e418d35eefb869d3cc35570e3daff",
       "7b47b07e3062f3dc839f11397bc3265120e01a35b0fda094d738e28a6729e6c3",
       "7c0dacd603b4381539d6d3cf21f5fe625cf54b05eb4aa750fce658529b11d81d",
       "7c79750557c7d7156df6f135fb582ec09cc5f4987ac8e2af0f5113e42c117224",
+      "7d083db061c678113c12453eb73299caa9e207dd6418ad63406154fd330f3309",
       "7d2239e2cd4893c57ac0bf1373a2ef46419f614d0ce18a12df51222bc7795327",
       "7e529bc76ca67f2023890da254ef0b09596f7d924d1a4eb93c72262783dc6c18",
       "7eab506921c339be748106aa49468dba61ebd5a93aabc111621ccc8a9df52cc9",
@@ -609,6 +628,7 @@
       "8b417f12b79e7328ab8998bde222da856470a9fe2a5eff838c710d5fc66c850e",
       "8c89d0106c4051f7400670c2e83e6e3cfd95533b6d4d5f715124f28dbf41c37e",
       "8cff7c530e70102f9506012e91f305c306c56a6e68073f44aba74a827c87f679",
+      "8d0079bdee4cf4dc86c1cca826f81584fe2c97db04514fdd666167df8b509979",
       "8d3788c5b6eb17b9c58873208bbd36df9e4d3f969563165095a9dbb17d6c73fe",
       "8db63678d5615054312a1b20b4383358fb0ec689e6ba6cb0d650bb133a2e3452",
       "9101242a1f901484fc6110064e8e3ff4d4935c0ed69ee76003b57f8faf020765",
@@ -647,9 +667,11 @@
       "a292850ee0ceb0549d2e0cd50e48c8596594a509597f7210f59acbad7b45b475",
       "a2b7ab33386255547ecd6fce85b574d0354ef8e93d2bafb58e0cb77d7fee46b7",
       "a2cb37971755afd2b67d7f91f0857ce9e0dee7464e8e16d79c72070bc0e5a5ef",
+      "a309b4f27f5733300e22b7b04a044b6c30df42b7ad51c9d03369e8d8d3da2f79",
       "a35c41356dc27962435aafef3aaad9060a987aa83ea01992da6f7c26612468c9",
       "a53c30ff3a184f3192f7c528b6cfe50dd917e8185edf31d66c5c1454abcbea9d",
       "a5700a94e3e29b246bd9e2e29b2292287687cedbb69902f0b87ffbdcf382915c",
+      "a5de90a81e905134db282ef1cd50e17a684c8ea3217630147a47e2d5058edc3f",
       "a624d3a28050dba8ceaf70f1e940c8a2d090c22a63118eee78fc1df154a88e2b",
       "a6bc0c56d741f39aea2dbceb9bdd671326f12cebf7468c9c0f1c2d8ae733acc4",
       "a880b449c712d425187e6119469d719a96f01f7a603de858022b385f47f84602",
@@ -701,6 +723,7 @@
       "bf636ba39e22c5f06aa4e4850e7e4c16e87eab4439b1c18d7bc5313d6c402cc6",
       "bfd30b5a63ea49031fefd4a7c7804c72731ea35ea47884d0aa154e9aeb83e805",
       "bfe131637d915e23907418c2ea412a31e4a0e3e90da24c96b3d23380d7f3ceaa",
+      "c115b2ba9ec7abe2fa5261a5894e3c4899794b527f01ec682ae7fd2479199c08",
       "c150c40a04099d7b726eb8aecc8eec8e92f9f9248a6a5c15556c08000c4bd231",
       "c16ff4fe013ee2cef905d767a09305d9c1b2f778a06b439f0bc4645ac05bc82b",
       "c1c7e45fedafb97770b6726539694eb0668c70677c2031fe2db2bc8b5339423a",
@@ -751,6 +774,7 @@
       "d606733e95736b3e28e4dce4847b9775effc0944c4cd54c733400074991934ef",
       "d660cb0c81a7032782da6910fa05eafa83d36520ca5fdb95e7077da96216a3ca",
       "d6df42e35e82f71f257f5e79d038bf60a96e4965dbdb6bf08bc95c250754e5fe",
+      "d905ca576280d8a3d774bcadebfa57a9e22bdf7c1678ca9a548a1c25d643bf17",
       "d94088aedb09a1feb3ad388a69e242043b4a921ca8d76b4660d94e18e2836546",
       "d9547a0d7d9a97bffa84178d8ab73f3556f22c34120759d50eaa165c3ef0c318",
       "d9683236273b7f1759c34a892267b1c57d59dec57415bb762201a50b5925c408",
@@ -772,6 +796,7 @@
       "e031aef2a9adb0d0900e8269cf84c892f77b9938984e26df54826d1771861629",
       "e0cecf4838b7ba38afa78577855d5bf7fab251d3f1b1ba01c51c0f76b97aea90",
       "e160cfba0b71557be31005767ee845cab16d8c3a9bafde3d12ec31e8af0a1339",
+      "e16ebeb4c7803de28999a926918b42bec8d548691719827a636d84bc47941d80",
       "e2070548ec9a6244c569ef0b9a43c2e5dd99cf9c0fa4540a21fd0595b291e444",
       "e29fec7d54a144ea4867a3764fccdee6849d58d0f32eacdd56b2c317863fa1c6",
       "e2e0fc585321ee2013cccaed95d47c49fbca71b54c67abad9080d19d70e3c1a5",
@@ -791,6 +816,7 @@
       "e97387270720794226b6f1c657a0d5a961dbe06f8b873d6150b2f6246e54891f",
       "eabe96ee6140792fb6d7c188c3ce031cba5e2c6663aecdeb019d9d51d5a90a43",
       "eaf6d28a8d55fb98dcd4ddb84ab4645b4bf6d328a26811ddfcc1423b0b8ea604",
+      "ed4a68efc0af88b2192a06ae6b208992b617aae54b768d125b95442b987d517b",
       "edb34ab257304ae32df0fd5b8d4b41e982ff5e956231e56b05c7bbc1e8ae44ca",
       "edd212c7b0941068f6fd2d2051ad28651acd16ee12d9400f060553af6274ed2e",
       "eddcbf50ba05f1f633fea0ad0a384300670be2ec6b45f8cc4f622aaa7a431b88",

package/config/skills/_shared/adapters/README.md

@@ -46,7 +46,7 @@ Keep each section to ≤ 8 lines. Adapters are deltas, not full prompts. If an a
 
 Adapters may add two more sections beyond the base format:
 
-- **`## Role eligibility`** — fixed ASCII fields, one per line: `executor: yes|no`, `pair_judge: yes|no`. Absent section = eligible for both roles (every adapter shipped before iter-0051). Present only when a backend is structurally unable or not certified for a role — e.g. a completion-only local model has no tool/file-edit access, so it declares `executor: no`. `_shared/engine-preflight.md` and `/devlyn:engines` read this section as a structured marker, not prose, so it validates mechanically.
+- **`## Role eligibility`** — fixed ASCII fields, one per line: `executor: yes|no`, `pair_judge: yes|no`. Absent section = eligible for both roles (every adapter shipped before iter-0051). Present only when a backend is structurally unable or not certified for a role — e.g. a completion-only local model has no tool/file-edit access, so it declares `executor: no`. `_shared/engine-preflight.md` and `/devlyn-engines` read this section as a structured marker, not prose, so it validates mechanically.
 - **`## Invocation`** — for backends called over an API or CLI backends with non-default invocation contracts: the concrete request shape (endpoint, JSON body, timeout) and the adapter-declared availability probe (`_shared/engine-preflight.md#role-resolution`'s "an adapter may declare a different probe" hook).
 
 ## When to add a new adapter

package/config/skills/_shared/adapters/omp.md

@@ -2,7 +2,7 @@
 
 ## Identity
 
-You are the model running behind the `omp` CLI. Follow the canonical phase prompt exactly; this adapter exists so oh-my-pi can be selected as a first-class native task worker by `/devlyn:resolve`.
+You are the model running behind the `omp` CLI. Follow the canonical phase prompt exactly; this adapter exists so oh-my-pi can be selected as a first-class native task worker by `/devlyn-resolve`.
 
 ## Output Discipline
 
@@ -10,4 +10,4 @@ Keep phase output machine-consumable and concise. Write the artifacts the canoni
 
 ## Fresh Context
 
-Each native `task` tool invocation with a fresh `context` is a fresh phase worker. Do not call `/devlyn:resolve` recursively from inside a phase prompt; execute only the phase body you received.
+Each native `task` tool invocation with a fresh `context` is a fresh phase worker. Do not call `/devlyn-resolve` recursively from inside a phase prompt; execute only the phase body you received.

package/config/skills/_shared/archive_run.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Archive devlyn:resolve run artifacts per references/pipeline-state.md#archive-contract.
+"""Archive devlyn-resolve run artifacts per references/pipeline-state.md#archive-contract.
 
 Usage:
     python3 scripts/archive_run.py [--devlyn-dir .devlyn]
@@ -67,7 +67,7 @@ PER_RUN_PATTERNS = (
     "verify.primary.timeout.json",
     "verify.pair.timeout.json",
     "finish-gate.summary.json",
-    # iter-0033a/2026-04-30 archive-fix iter: NEW /devlyn:resolve emits
+    # iter-0033a/2026-04-30 archive-fix iter: NEW /devlyn-resolve emits
     # plan.md (PLAN output) + final-report.md (PHASE 6 render) +
     # cumulative.patch (cumulative diff). Smoke 2's archive listing
     # captured all three; archive_run.py was missing them because the