@haus-tech/haus-workflow 0.16.2 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.17.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.16.3...v0.17.0) (2026-06-09)
+
+### Features
+
+- **catalog:** support curated superpowers skills and commands ([#80](https://github.com/WeAreHausTech/haus-workflow/issues/80)) ([2e49c80](https://github.com/WeAreHausTech/haus-workflow/commit/2e49c80d6780e8ff753536f2d4042b4ce7fa2ae8))
+
+## [0.16.3](https://github.com/WeAreHausTech/haus-workflow/compare/v0.16.2...v0.16.3) (2026-06-09)
+
+### Bug Fixes
+
+- **install:** keep skill frontmatter valid by stamping marker as a field ([#79](https://github.com/WeAreHausTech/haus-workflow/issues/79)) ([76ddbf1](https://github.com/WeAreHausTech/haus-workflow/commit/76ddbf1248b8844538363dcfd3744cd975d96f52))
+
 ## [0.16.2](https://github.com/WeAreHausTech/haus-workflow/compare/v0.16.1...v0.16.2) (2026-06-09)
 
 ## [0.16.1](https://github.com/WeAreHausTech/haus-workflow/compare/v0.16.0...v0.16.1) (2026-06-09)

package/dist/cli.js

@@ -137,7 +137,7 @@ async function syncRemoteCatalog() {
   let unchanged = 0;
   const failed = [];
   for (const item of items) {
-    if (item.type !== "skill" && item.type !== "agent" && item.type !== "template" || !item.path)
+    if (item.type !== "skill" && item.type !== "agent" && item.type !== "template" && item.type !== "command" || !item.path)
       continue;
     if (!isSafeCatalogPath(item.path)) {
       warn(`Skipping ${item.id}: invalid path "${item.path}"`);
@@ -1240,7 +1240,7 @@ async function writeClaudeFiles(root, dryRun, selectedIds, opts = {}) {
       }
     }
     const sourcePath = catalogItemContentPath(contentRoot, manifestItem);
-    const target = item.type === "agent" ? "agents" : item.type === "template" ? "templates" : "skills";
+    const target = item.type === "agent" ? "agents" : item.type === "template" ? "templates" : item.type === "command" ? "commands" : "skills";
     const destination = claudePath(root, target, path12.basename(sourcePath));
     if (await fs10.pathExists(sourcePath)) {
       if (dryRun) {
@@ -1549,7 +1549,8 @@ var validation_rules_default = {
     "baseline",
     "project-instructions"
   ],
-  patternTagSuffixes: ["-patterns"]
+  patternTagSuffixes: ["-patterns"],
+  skillSectionExemptSources: ["curated"]
 };
 
 // src/catalog/validation-rules.ts
@@ -1557,6 +1558,10 @@ var toRegExp = (r) => new RegExp(r.source, r.flags);
 var FORBIDDEN_TAGS = validation_rules_default.forbiddenTags;
 var BANNED_AGENT_PHRASES = validation_rules_default.bannedAgentPhrases;
 var REQUIRED_SKILL_SECTIONS = validation_rules_default.requiredSkillSections;
+var SKILL_SECTION_EXEMPT_SOURCES = validation_rules_default.skillSectionExemptSources;
+function isVerbatimSuperpowersMarkdownPath(rel) {
+  return rel.replace(/\\/g, "/").includes("/superpowers/");
+}
 var REQUIRED_AGENT_SECTIONS = validation_rules_default.requiredAgentSections;
 var RISKY_INSTALL_PATTERNS = validation_rules_default.riskyInstallPatterns.map(toRegExp);
 var ALLOWED_NPX_PATTERN = toRegExp(validation_rules_default.allowedNpxPattern);
@@ -3323,6 +3328,8 @@ import fs15 from "fs-extra";
 // src/install/header.ts
 var MD_PREFIX = "<!-- HAUS-MANAGED";
 var MD_SUFFIX = " -->";
+var FM_FENCE = "---";
+var FM_KEY = "haus_managed";
 function parseAttrs(raw) {
   const idMatch = /\bid=(\S+)/.exec(raw);
   const vMatch = /\bv=(\S+)/.exec(raw);
@@ -3330,20 +3337,67 @@ function parseAttrs(raw) {
   if (!idMatch || !vMatch || !srcMatch) return void 0;
   return { stableId: idMatch[1], schemaVersion: vMatch[1], source: srcMatch[1] };
 }
+function isFence(line2) {
+  return (line2 ?? "").replace(/\r$/, "") === FM_FENCE;
+}
+function hasFrontmatter(content2) {
+  return isFence(content2.split("\n", 1)[0]);
+}
+function frontmatterMarkerValue(content2) {
+  const lines = content2.split("\n");
+  if (!isFence(lines[0])) return void 0;
+  for (let i = 1; i < lines.length; i++) {
+    if (isFence(lines[i])) return void 0;
+    const m = /^haus_managed:\s*"?(.*?)"?\s*$/.exec(lines[i]);
+    if (m) return m[1];
+  }
+  return void 0;
+}
 function parseMarkdownHeader(content2) {
   const firstLine = content2.split("\n")[0] ?? "";
-  if (!firstLine.startsWith(MD_PREFIX)) return void 0;
-  return parseAttrs(firstLine);
+  if (firstLine.startsWith(MD_PREFIX)) return parseAttrs(firstLine);
+  const fmValue = frontmatterMarkerValue(content2);
+  if (fmValue !== void 0) return parseAttrs(fmValue);
+  return void 0;
 }
 function buildMarkdownHeader(h) {
   return `${MD_PREFIX} id=${h.stableId} v=${h.schemaVersion} source=${h.source}${MD_SUFFIX}`;
 }
+function buildMarkerValue(h) {
+  return `id=${h.stableId} v=${h.schemaVersion} source=${h.source}`;
+}
+function stampFrontmatter(content2, h) {
+  const lines = content2.split("\n");
+  let close = -1;
+  for (let i = 1; i < lines.length; i++) {
+    if (isFence(lines[i])) {
+      close = i;
+      break;
+    }
+  }
+  if (close === -1) return content2;
+  const fields2 = [];
+  for (let i = 1; i < close; i++) {
+    if (/^haus_managed:/.test(lines[i])) continue;
+    fields2.push(lines[i]);
+  }
+  const rebuilt = [
+    FM_FENCE,
+    ...fields2,
+    `${FM_KEY}: "${buildMarkerValue(h)}"`,
+    ...lines.slice(close)
+    // closing fence + body
+  ];
+  return rebuilt.join("\n");
+}
 function stampMarkdown(content2, h) {
+  if (hasFrontmatter(content2)) return stampFrontmatter(content2, h);
   const header = buildMarkdownHeader(h);
-  const existing = parseMarkdownHeader(content2);
-  if (existing) {
-    const rest = content2.slice(content2.indexOf("\n") + 1);
-    return `${header}
+  const firstLine = content2.split("\n")[0] ?? "";
+  if (firstLine.startsWith(MD_PREFIX)) {
+    const nl = content2.indexOf("\n");
+    const rest = nl === -1 ? "" : content2.slice(nl + 1);
+    return rest === "" ? header : `${header}
 ${rest}`;
   }
   return `${header}
@@ -4081,7 +4135,7 @@ function auditManifestStructure(items) {
     } else {
       seenIds.set(item.id, i);
     }
-    if (item.type === "skill" || item.type === "agent" || item.type === "template") {
+    if (item.type === "skill" || item.type === "agent" || item.type === "template" || item.type === "command") {
       if (!item.path) {
         failures.push(`${item.id}: missing path`);
       } else {
@@ -4119,8 +4173,11 @@ function auditShippedFiles(manifestDir, items) {
         continue;
       }
       const text = fs18.readFileSync(skillMd, "utf8");
-      for (const section of REQUIRED_SKILL_SECTIONS) {
-        if (!text.includes(section)) failures.push(`${item.id}: SKILL.md missing ${section}`);
+      const skillSectionExempt = SKILL_SECTION_EXEMPT_SOURCES.includes(item.source) && item.whenToUse && item.whenNotToUse;
+      if (!skillSectionExempt) {
+        for (const section of REQUIRED_SKILL_SECTIONS) {
+          if (!text.includes(section)) failures.push(`${item.id}: SKILL.md missing ${section}`);
+        }
       }
       failures.push(
         ...auditForbiddenTagsInText(text, `${item.id}: ${path26.relative(manifestDir, skillMd)}`)
@@ -4149,6 +4206,12 @@ function auditShippedFiles(manifestDir, items) {
         continue;
       }
       failures.push(...auditTemplateContent(manifestDir, absPath, item.id));
+    } else if (item.type === "command") {
+      if (!fs18.existsSync(absPath)) {
+        failures.push(`${item.id}: missing command file ${item.path}`);
+        continue;
+      }
+      failures.push(...auditTemplateContent(manifestDir, absPath, item.id));
     }
   }
   return failures;
@@ -4175,13 +4238,14 @@ function auditTemplateContent(manifestDir, absPath, itemId) {
 }
 function auditMarkdownContent(manifestDir) {
   const failures = [];
-  const dirs = ["skills", "agents", "templates"];
+  const dirs = ["skills", "agents", "templates", "commands"];
   for (const dir of dirs) {
     const abs = path26.join(manifestDir, dir);
     if (!fs18.existsSync(abs)) continue;
     walkMd(abs, (file) => {
       const text = fs18.readFileSync(file, "utf8");
       const rel = path26.relative(manifestDir, file);
+      if (isVerbatimSuperpowersMarkdownPath(rel)) return;
       const lines = text.split(/\r?\n/);
       for (let i = 0; i < lines.length; i++) {
         const line2 = lines[i] ?? "";

package/library/catalog/validation-rules.json

@@ -142,5 +142,6 @@
     "baseline",
     "project-instructions"
   ],
-  "patternTagSuffixes": ["-patterns"]
+  "patternTagSuffixes": ["-patterns"],
+  "skillSectionExemptSources": ["curated"]
 }

package/library/global/skills/haus-workflow/SKILL.md

@@ -1,8 +1,6 @@
-## <!-- HAUS-MANAGED id=skill.haus-workflow v=2 source=@haus-tech/haus-workflow@0.1.0 -->
-
+---
 name: haus-workflow
 description: Haus all-in-one workflow skill. Handles project setup, update, catalog refresh, and CLAUDE.md regeneration. Invoke with a task name or without to get a menu.
-
 ---
 
 # haus-workflow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "Haus AI workflow CLI for Claude Code.",
   "type": "module",
   "bin": {
@@ -18,9 +18,7 @@
     "library/catalog",
     "tests/fixtures/catalog",
     "README.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "NOTICE"
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup src/cli.ts --format esm --dts --clean --out-dir dist --external @inquirer/checkbox",
@@ -34,8 +32,6 @@
     "typecheck": "tsc --noEmit",
     "typecheck:scripts": "tsc --noEmit --project tsconfig.scripts.json",
     "pack:local": "yarn pack",
-    "publish:dry": "npm pack --dry-run",
-    "publish:public": "yarn npm publish --access public",
     "release": "GITHUB_TOKEN=$(gh auth token) release-it",
     "release:dry": "GITHUB_TOKEN=$(gh auth token) release-it --dry-run",
     "prepack": "yarn build",