@haus-tech/haus-workflow 0.16.1 → 0.16.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [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)
 
 ## [0.16.0](https://github.com/WeAreHausTech/haus-workflow/compare/v0.15.0...v0.16.0) (2026-06-05)

package/README.md

@@ -29,13 +29,17 @@ and configures the repo for you.
 
 Once installed, Claude Code gains a `/haus-workflow` slash command.
 
+The `project:*` tasks act on the current repo. The unprefixed verbs (`update`,
+`catalog`, `install`, `uninstall`) manage the haus tool itself on your machine
+(`~/.claude` + npm), like `npm install -g`. The short legacy names still work.
+
 ```
-/haus-workflow          # interactive menu — pick setup, update, refresh, etc.
-/haus-workflow setup    # full first-time setup — scaffolding, skills, commands + docs (runs the /haus-setup flow)
-/haus-workflow apply    # refresh .claude/ and regenerate CLAUDE.md imports
-/haus-workflow update   # update npm package + catalog + ~/.claude/
-/haus-workflow catalog  # fetch only latest catalog
-/haus-workflow doctor   # health check for drift
+/haus-workflow                 # interactive menu — pick a task
+/haus-workflow project:init    # [project] add haus to an EXISTING repo — AI skills, commands, workflow + docs
+/haus-workflow project:refresh # [project] refresh .claude/ and regenerate CLAUDE.md imports
+/haus-workflow project:doctor  # [project] health check for drift
+/haus-workflow update          # [global]  update npm package + catalog + ~/.claude/
+/haus-workflow catalog         # [global]  fetch only the latest catalog
 ```
 
 Without an argument, the skill presents a menu so you can pick the task. With an argument, it runs immediately.

package/dist/cli.js

@@ -3323,6 +3323,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 +3332,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}

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
@@ -17,16 +15,21 @@ All-in-one entry point for the Haus AI workflow.
 
 ## Task aliases → commands
 
-| Alias(es)                            | Command                 | What it does                                                        |
-| ------------------------------------ | ----------------------- | ------------------------------------------------------------------- |
-| `init`, `setup`                      | _Setup procedure below_ | Full first-time setup: scaffolding, skills, commands + project docs |
-| `apply`, `refresh`, `update-project` | `haus apply --write`    | Re-run setup / refresh `.claude/` context                           |
-| `update`, `upgrade`                  | `haus update`           | Update npm package + catalog + `~/.claude/`                         |
-| `catalog`                            | `haus update`           | Fetch latest catalog (same command as update)                       |
-| `doctor`, `check`                    | `haus doctor`           | Check for install drift                                             |
-| `install`, `global`                  | `haus install`          | Seed `~/.claude/` with haus-owned files                             |
-| `uninstall`                          | `haus uninstall`        | Remove all haus global files from `~/.claude/`                      |
-| `claude-md`, `regenerate`            | `haus apply --write`    | Regenerate root `CLAUDE.md` import block                            |
+Task names use an asymmetric scope convention. The **project:** namespace marks tasks that
+act on **this repo** (`./.claude`, `./.haus-workflow`) — type `project:` to see them all.
+The unprefixed verbs (`update`, `catalog`, `install`, `uninstall`) act on **this machine's
+haus install** (`~/.claude`, npm) — they manage the haus tool itself, like `npm install -g`.
+The short legacy aliases still work but the names below are canonical.
+
+| Task name (legacy aliases)                                        | Command                 | Scope   | What it does                                                                                |
+| ----------------------------------------------------------------- | ----------------------- | ------- | ------------------------------------------------------------------------------------------- |
+| `project:init` (`setup`, `init`)                                  | _Setup procedure below_ | project | First-time setup of an **existing** repo: adds AI skills, commands, workflow + project docs |
+| `project:refresh` (`apply`, `refresh`, `claude-md`, `regenerate`) | `haus apply --write`    | project | Re-run setup / refresh `.claude/` context + regenerate root `CLAUDE.md` import block        |
+| `project:doctor` (`doctor`, `check`)                              | `haus doctor`           | project | Check for install drift                                                                     |
+| `update` (`upgrade`)                                              | `haus update`           | global  | Update npm package + catalog + `~/.claude/` (also refreshes this project)                   |
+| `catalog`                                                         | `haus update`           | global  | Fetch latest catalog (same command as update)                                               |
+| `install` (`global`)                                              | `haus install`          | global  | Seed `~/.claude/` with haus-owned files                                                     |
+| `uninstall`                                                       | `haus uninstall`        | global  | Remove all haus global files from `~/.claude/`                                              |
 
 ## Step 1 — Determine the task
 
@@ -37,16 +40,14 @@ All-in-one entry point for the Haus AI workflow.
 ```
 Question: "What would you like to do?"
 Options:
-  1. Set up this project for the first time
-     (full setup — scaffolding + skills + commands, then a deep read to write the CLAUDE.md docs body + docs/)
-  2. Refresh project setup
+  1. [project] project:init — add haus to an existing project for the first time
+     (AI skills + commands + workflow into a repo you already have, then a deep read to write the CLAUDE.md docs body + docs/)
+  2. [project] project:refresh — refresh this project's setup
      (haus apply --write — re-runs setup, regenerates CLAUDE.md imports)
-  3. Update haus package + catalog + global files
+  3. [global] update — update haus package + catalog + global files
      (haus update — checks npm for new version, fetches catalog, refreshes ~/.claude/)
-  4. Fetch catalog updates only
+  4. [global] catalog — fetch catalog updates only
      (haus update — same command; pulls latest workflow templates and lockfile)
-  5. Regenerate CLAUDE.md import block
-     (haus apply --write — rewrites the @-import block at the root CLAUDE.md)
 ```
 
 Map the user's selection to the command from the alias table, then continue to Step 2.
@@ -55,13 +56,13 @@ Map the user's selection to the command from the alias table, then continue to S
 
 Run the mapped command via Bash. Quote the exact command you are running before executing it.
 
-**Exception — `setup` / `init`:** this maps to a multi-step procedure, not a single command. Do not run a bare `haus init`. Skip to **Setup (`setup` / `init`)** under Step 3 and follow it.
+**Exception — `project:init` (`setup` / `init`):** this maps to a multi-step procedure, not a single command. Do not run a bare `haus init`. Skip to **Setup (`project:init`)** under Step 3 and follow it.
 
 ## Step 3 — Post-run steps
 
 After the command completes, follow the relevant post-run steps below.
 
-### Setup (`setup` / `init`)
+### Setup (`project:init`)
 
 1. Open and follow `~/.claude/commands/haus-setup.md` — the installed `haus-setup` command (in some projects also `.claude/commands/haus-setup.md`). Run every step in order. It detects the stack, asks the guided questions, runs `haus apply --write` (scaffolding, skills, commands, rules, docs skill), writes the **project docs** (`CLAUDE.md` body + `docs/`) and `.haus-workflow/deep-context.json`, runs `haus recommend`, applies the newly-matched helpers, and confirms.
 2. Then fill `.haus-workflow/workflow-config.md` — replace every placeholder (`TODO`, `n/a`, empty): test/lint/typecheck/build commands (check `package.json`), docs paths, validation library, pre-commit tool, highest-stakes logic (ask if unclear). Leave none.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "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",