@delorenj/pjangler 1.5.11 → 1.5.13

package/.mise/scripts/versioning.sh

@@ -16,10 +16,12 @@
 #   versioning.sh files                List the manifest
 #
 # Manifest: .mise/version-files.conf  — lines of "<type> <path>" (see file-types).
-#   types: json toml cargo csproj gradle plain gittag
+#   types: json toml cargo csproj gradle plain gittag obsidian
 #
 # Storage format per type:
 #   json/toml/cargo/csproj/gradle/plain -> bare  "X.Y.Z"
+#   obsidian (manifest.json)            -> bare  "X.Y.Z", plus the sibling
+#                                          versions.json gains X.Y.Z -> minAppVersion
 #   gittag                              -> tag   "vX.Y.Z"
 # `current` always prints with the leading "v".
 
@@ -85,12 +87,21 @@ manifest_entries() {
   done <"$MANIFEST"
 }
 
+# Rewrite a JSON file through jq, keeping its indentation: tab-indented files
+# (Obsidian's manifest.json/versions.json/package.json) stay tab-indented.
+jq_rewrite() {  # $1=path, remaining args go to jq
+  local path="$1" tmp indent=(--indent 2); shift
+  grep -q $'^\t' "$path" && indent=(--tab)
+  tmp="$(mktemp)"
+  jq "${indent[@]}" "$@" "$path" >"$tmp" && mv "$tmp" "$path"
+}
+
 # ---- per-type read -----------------------------------------------------------
 
 read_version() {  # $1=type $2=path -> bare X.Y.Z on stdout, or nothing
   local type="$1" path="$2" raw=""
   case "$type" in
-    json)
+    json|obsidian)
       [[ -f "$path" ]] || return 0
       raw="$(jq -r '.version // empty' "$path" 2>/dev/null || true)" ;;
     toml|cargo)
@@ -119,12 +130,22 @@ read_version() {  # $1=type $2=path -> bare X.Y.Z on stdout, or nothing
 # ---- per-type write ----------------------------------------------------------
 
 write_version() {  # $1=type $2=path $3=bare-new-version
-  local type="$1" path="$2" new="$3" tmp
+  local type="$1" path="$2" new="$3"
   case "$type" in
     json)
       [[ -f "$path" ]] || return 0
-      tmp="$(mktemp)"
-      jq --indent 2 --arg v "$new" '.version = $v' "$path" >"$tmp" && mv "$tmp" "$path" ;;
+      jq_rewrite "$path" --arg v "$new" '.version = $v' ;;
+    obsidian)
+      # What the sample plugin's version-bump.mjs does: set the manifest
+      # version, then record new -> minAppVersion in versions.json (once).
+      [[ -f "$path" ]] || return 0
+      jq_rewrite "$path" --arg v "$new" '.version = $v'
+      local versions min
+      versions="$(dirname "$path")/versions.json"
+      min="$(jq -r '.minAppVersion // empty' "$path")"
+      if [[ -f "$versions" && -n "$min" ]]; then
+        jq_rewrite "$versions" --arg v "$new" --arg m "$min" 'if has($v) then . else .[$v] = $m end'
+      fi ;;
     toml|cargo)
       [[ -f "$path" ]] || return 0
       # Replace only the first top-level `version = "..."` line.

package/README.md

@@ -76,6 +76,31 @@ instead of reading a clean report over nothing.
 live catalog. The rules are owned by the recipes in `src/recipes/`, not by a
 central table, so that catalog is the only authority on which ones exist.
 
+## Obsidian plugins
+
+`pjangler init <name> --obsidian-plugin` does everything a normal init does
+(registry, `.project.json`, board, BMAD, skills, hooks, mise, the init commit).
+The difference is the CommonProject render: it is the variant built on the
+canonical [obsidian-sample-plugin](https://github.com/obsidianmd/obsidian-sample-plugin).
+That means `manifest.json`, `versions.json`, npm + esbuild + TypeScript in `src/`,
+`eslint-plugin-obsidianmd`, and build/release workflows on the self-hosted runners.
+
+```bash
+pjangler init tag-wrangler --obsidian-plugin --description "Wrangle tags across a vault"
+cd tag-wrangler && npm install && npm run dev
+mise run plugin:link ~/Vaults/Main   # symlink into <vault>/.obsidian/plugins/<id>
+```
+
+- The type is recorded as `template.commonproject.project_type` and in
+  `.copier-answers.yml`. It is fixed at creation, and re-running `init` keeps it.
+- On an existing repo, the flag only records the type, and only when the repo
+  already has an Obsidian `manifest.json`.
+- `mise run version:bump` keeps `package.json`, `manifest.json` and `versions.json`
+  in step. It never tags. Release with `npm version patch|minor|major`, which
+  commits and then tags a bare `X.Y.Z` (Obsidian matches that), and push the tag.
+- MCP takes the same choice as `projectType: "obsidian-plugin"` on
+  `pjangler_project_init` and `pjangler_bootstrap_33god_project`.
+
 ## Agents
 
 pjangler does not hire, provision, or inspect agents. That is Flume's surface —

package/dist/index.js

@@ -968,6 +968,38 @@ import { homedir as homedir5, tmpdir } from "node:os";
 import { basename as basename7, delimiter as delimiter2, dirname as dirname11, isAbsolute as isAbsolute5, join as join12, relative as relative7, resolve as resolve10, sep as sep2, win32 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import YAML4 from "yaml";
+function normalizeProjectType(value, label = "Project type") {
+  const text2 = typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (PROJECT_TYPES.includes(text2)) return text2;
+  throw new Error(`${label} ${JSON.stringify(value)} is not one of: ${PROJECT_TYPES.join(", ")}`);
+}
+function looksLikeObsidianPlugin(dir) {
+  try {
+    const manifest = JSON.parse(readFileSync10(join12(dir, "manifest.json"), "utf8"));
+    return isRecord3(manifest) && typeof manifest.id === "string" && typeof manifest.minAppVersion === "string";
+  } catch {
+    return false;
+  }
+}
+function assertTemplateOffersProjectType(pjanglerRoot, projectType) {
+  if (projectType === "base") return;
+  const copierYml = join12(pjanglerRoot, "templates", "commonproject", "copier.yml");
+  let choices;
+  try {
+    const parsed = YAML4.parse(readFileSync10(copierYml, "utf8"));
+    choices = isRecord3(parsed) && isRecord3(parsed.project_type) ? parsed.project_type.choices : void 0;
+  } catch {
+    choices = void 0;
+  }
+  const offered = isRecord3(choices) ? Object.values(choices) : Array.isArray(choices) ? choices : [];
+  if (!offered.includes(projectType)) {
+    throw new Error(`The CommonProject template at ${dirname11(copierYml)} cannot render project type "${projectType}" (its copier.yml offers no such project_type); update pjangler or its templates/commonproject pin`);
+  }
+}
+function operatorDisplayName(cwd) {
+  const result2 = spawnSync5("git", ["config", "--get", "user.name"], { cwd: existsSync7(cwd) ? cwd : void 0, encoding: "utf8", timeout: 5e3 });
+  return result2.status === 0 ? result2.stdout.trim() : "";
+}
 function providerAssignsIdentifiers(type) {
   return IDENTIFIER_ASSIGNING_PROVIDERS.includes((type ?? "").trim());
 }
@@ -1560,6 +1592,26 @@ function planProjectInit(input) {
   const overwrite = input.overwrite ?? input.force ?? false;
   const agents = createSafeRecord(Object.entries(existing?.agents ?? {}));
   const scaffold = input.scaffold ?? true;
+  const recordedTypeValue = existing?.template?.commonproject?.project_type;
+  const recordedType = recordedTypeValue === void 0 ? void 0 : normalizeProjectType(recordedTypeValue, `Recorded project type of ${slug}`);
+  const requestedType = input.projectType === void 0 ? void 0 : normalizeProjectType(input.projectType);
+  const freshRender = scaffold && localManifest === void 0 && !existsSync7(join12(targetDir, ".copier-answers.yml"));
+  if (requestedType && !freshRender && requestedType !== (recordedType ?? "base")) {
+    const adoptingPlugin = !scaffold && recordedType === void 0 && requestedType === "obsidian-plugin" && looksLikeObsidianPlugin(targetDir);
+    if (!adoptingPlugin) {
+      throw new Error(scaffold || recordedType !== void 0 ? `Project type "${requestedType}" conflicts with ${slug}'s recorded type "${recordedType ?? "base"}"; a project's type is fixed when it is created` : `${targetDir} is adopted as-is, so "${requestedType}" would render nothing, and the repo is not one already (no Obsidian manifest.json with id and minAppVersion)`);
+    }
+  }
+  const projectType = requestedType ?? recordedType ?? "base";
+  const typeLanguages = PROJECT_TYPE_LANGUAGES[projectType];
+  if (input.primaryLanguage !== void 0 && typeLanguages && !typeLanguages.includes(input.primaryLanguage)) {
+    throw new Error(`A ${projectType} project is written in ${typeLanguages.join(" or ")}, not ${input.primaryLanguage}`);
+  }
+  const recordedLanguageValue = (localManifest ? localManifest.template : indexed?.template)?.commonproject?.primary_language;
+  const recordedLanguage = typeof recordedLanguageValue === "string" && recordedLanguageValue ? recordedLanguageValue : void 0;
+  const newlyTyped = requestedType !== void 0 && requestedType !== recordedType;
+  const recordedLanguageFits = !typeLanguages || recordedLanguage !== void 0 && typeLanguages.includes(recordedLanguage);
+  const primaryLanguage = input.primaryLanguage ?? (newlyTyped && !recordedLanguageFits ? typeLanguages?.[0] : void 0) ?? recordedLanguage ?? typeLanguages?.[0] ?? "python";
   const candidateProject = {
     ...existing ?? {},
     name: input.name,
@@ -1581,7 +1633,10 @@ function planProjectInit(input) {
       commonproject: {
         ...existing?.template?.commonproject,
         enabled: true,
-        primary_language: input.primaryLanguage ?? existing?.template?.commonproject?.primary_language ?? "python"
+        primary_language: primaryLanguage,
+        // Written only for a non-base type (or one already recorded), so a
+        // base record never gains a key and stays equivalent to its last run.
+        ...projectType !== "base" || recordedType !== void 0 ? { project_type: projectType } : {}
       }
     },
     ticket_provider: { ...existing?.ticket_provider, ...buildTicketProviderBlock({
@@ -1617,6 +1672,7 @@ function planProjectInit(input) {
     { kind: "registry.upsert", registryPath, slug, project }
   ];
   if (scaffold) {
+    assertTemplateOffersProjectType(pjanglerRoot, projectType);
     actions.push(buildCommonProjectCopierAction({
       pjanglerRoot,
       targetDir,
@@ -1630,6 +1686,8 @@ function planProjectInit(input) {
       boardId: project.ticket_provider.board_id ?? "",
       projectIdentifier: identifier,
       primaryLanguage: project.template.commonproject.primary_language,
+      projectType,
+      ...projectType === "obsidian-plugin" ? { pluginAuthor: operatorDisplayName(input.cwd ?? process.cwd()) } : {},
       agentHooksLayer: resolveAgentHooksLayer2(input.agentHooksLayer),
       overwrite
     }));
@@ -1768,6 +1826,13 @@ async function executeProjectInitPlan(plan, options = {}) {
         errors.push(`copier exited with status ${result2.status ?? "unknown"}`);
         break;
       }
+      const projectType = action.data.project_type ?? "base";
+      const missing = (PROJECT_TYPE_SENTINELS[projectType] ?? []).filter((rel) => !existsSync7(join12(action.targetDir, rel)));
+      if (missing.length) {
+        errors.push(`copier rendered no ${projectType} project: ${missing.join(", ")} missing from ${action.targetDir}`);
+        break;
+      }
+      if (projectType !== "base") logs.push(`commonproject: rendered as ${projectType}`);
     } else if (action.kind === "project.write-manifest") {
       if (action.expectedContent !== void 0 && (!existsSync7(action.path) || readFileSync10(action.path, "utf8") !== action.expectedContent)) {
         errors.push(`Manifest changed after planning: ${action.path}; re-plan before applying`);
@@ -1887,13 +1952,18 @@ function formatProjectInitPlan(plan) {
   lines.push(`  ${cyan(bold(glyph.chevron))} ${title}${plan.dryRun ? `  ${dim(glyph.dot)}  ${yellow("dry run")}` : ""}`);
   lines.push(`  ${dim("registry".padEnd(8))} ${dim(plan.registryPath)}`);
   lines.push(`  ${dim("target".padEnd(8))} ${dim(plan.project.repo_path)}`);
+  const projectType = plan.project.template?.commonproject?.project_type;
+  if (projectType && projectType !== "base") lines.push(`  ${dim("type".padEnd(8))} ${cyan(projectType)}`);
   for (const warning of plan.warnings ?? []) lines.push(`  ${yellow(glyph.warn)} ${warning}`);
   lines.push("");
   lines.push(`  ${bold("Actions")} ${dim(`(${plan.actions.length})`)}`);
   if (!plan.actions.length) lines.push(`     ${dim("(nothing to do)")}`);
   for (const action of plan.actions) {
     lines.push(`     ${cyan(glyph.bullet)} ${action.kind}`);
-    if (action.kind === "copier.copy.commonproject") lines.push(`        ${dim(`target: ${action.targetDir}`)}`);
+    if (action.kind === "copier.copy.commonproject") {
+      lines.push(`        ${dim(`target: ${action.targetDir}`)}`);
+      if (action.data.project_type && action.data.project_type !== "base") lines.push(`        ${dim(`type: ${action.data.project_type}`)}`);
+    }
     if (action.kind === "project.write-manifest") lines.push(`        ${dim(`path: ${action.path}`)}`);
     if (action.kind === "ticket-provider.create-or-link") {
       const target = [action.provider, action.workspace, action.identifier].filter(Boolean).join("/");
@@ -2014,6 +2084,8 @@ function buildCommonProjectCopierAction(input) {
     board_id: input.boardId ?? input.planeProjectId ?? "",
     project_identifier: input.projectIdentifier,
     primary_language: input.primaryLanguage,
+    project_type: input.projectType ?? "base",
+    ...input.pluginAuthor !== void 0 ? { plugin_author: input.pluginAuthor } : {},
     agent_hooks_layer: input.agentHooksLayer ?? true ? "true" : "false"
   };
   const command = ["copier", "copy", "--trust", "--vcs-ref=HEAD", templateDir, input.targetDir, "--defaults"];
@@ -2114,7 +2186,7 @@ function expandHome(path) {
 function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var PROJECT_SOURCE_SKILL_ROOTS_ENV, TICKET_PROVIDER_ADAPTERS_ENV, PROJECT_REGISTRY_SCHEMA_VERSION, DEFAULT_NEW_PROJECT_STATUS, BOARD_URL_DEPRECATION_WARNING, PROJECT_IDENTIFIER_SOURCES, IDENTIFIER_ASSIGNING_PROVIDERS, TICKET_PROVIDER_STATES, IDENTIFIER_REPAIR_COMMAND, DEFAULT_SOURCE_SKILL_ROOTS, PROJECT_REGISTRY_OWNED_KEYS, PROJECT_NOTEBOOK_OWNED_KEYS, TICKET_PROVIDER_OWNED_KEYS, GLOBAL_NOTEBOOK_OWNED_KEYS, GLOBAL_NOTEBOOK_AUTH_OWNED_KEYS, GLOBAL_NOTEBOOK_DEFAULTS_OWNED_KEYS, GLOBAL_NOTEBOOK_LIMITS_OWNED_KEYS, GLOBAL_NOTEBOOK_SUMMARIZER_OWNED_KEYS, SAFE_PATH_SEGMENT;
+var PROJECT_SOURCE_SKILL_ROOTS_ENV, TICKET_PROVIDER_ADAPTERS_ENV, PROJECT_REGISTRY_SCHEMA_VERSION, DEFAULT_NEW_PROJECT_STATUS, PROJECT_TYPES, PROJECT_TYPE_LANGUAGES, PROJECT_TYPE_SENTINELS, BOARD_URL_DEPRECATION_WARNING, PROJECT_IDENTIFIER_SOURCES, IDENTIFIER_ASSIGNING_PROVIDERS, TICKET_PROVIDER_STATES, IDENTIFIER_REPAIR_COMMAND, DEFAULT_SOURCE_SKILL_ROOTS, PROJECT_REGISTRY_OWNED_KEYS, PROJECT_NOTEBOOK_OWNED_KEYS, TICKET_PROVIDER_OWNED_KEYS, GLOBAL_NOTEBOOK_OWNED_KEYS, GLOBAL_NOTEBOOK_AUTH_OWNED_KEYS, GLOBAL_NOTEBOOK_DEFAULTS_OWNED_KEYS, GLOBAL_NOTEBOOK_LIMITS_OWNED_KEYS, GLOBAL_NOTEBOOK_SUMMARIZER_OWNED_KEYS, SAFE_PATH_SEGMENT;
 var init_project = __esm({
   "src/project/index.ts"() {
     "use strict";
@@ -2130,6 +2202,13 @@ var init_project = __esm({
     TICKET_PROVIDER_ADAPTERS_ENV = "PJ_TICKET_PROVIDER_ADAPTERS";
     PROJECT_REGISTRY_SCHEMA_VERSION = 1;
     DEFAULT_NEW_PROJECT_STATUS = "active";
+    PROJECT_TYPES = ["base", "obsidian-plugin"];
+    PROJECT_TYPE_LANGUAGES = {
+      "obsidian-plugin": ["typescript", "javascript"]
+    };
+    PROJECT_TYPE_SENTINELS = {
+      "obsidian-plugin": ["manifest.json", join12("src", "main.ts")]
+    };
     BOARD_URL_DEPRECATION_WARNING = "boardUrl is deprecated and ignored; board URLs are derived at runtime and are never persisted.";
     PROJECT_IDENTIFIER_SOURCES = ["provider", "proposed"];
     IDENTIFIER_ASSIGNING_PROVIDERS = ["plane", "linear"];
@@ -8510,9 +8589,24 @@ function lstatIfPresent(path) {
   }
 }
 function templateVersionFilesConf(ctx, repoRoot) {
+  if (isObsidianPluginRepo(ctx, repoRoot)) return OBSIDIAN_VERSION_FILES_CONF;
   const packageJson = join5(repoRoot, "package.json");
   return existsSync3(packageJson) ? "# mise-versioning manifest: <type> <path>\n# types: json toml cargo csproj gradle plain gittag\njson package.json\ngittag .\n" : "# mise-versioning manifest: <type> <path>\n# types: json toml cargo csproj gradle plain gittag\ngittag .\n";
 }
+var OBSIDIAN_VERSION_FILES_CONF = "# mise-versioning manifest: <type> <path>\n# types: json toml cargo csproj gradle plain gittag obsidian\n# Obsidian plugin: bump with `mise run version:bump`, release with `npm version` (bare X.Y.Z tag).\njson package.json\nobsidian manifest.json\n";
+function recordedProjectType(ctx) {
+  return record(record(readProjectJson(ctx)?.template).commonproject).project_type;
+}
+function isObsidianPluginRepo(ctx, repoRoot) {
+  const recorded = recordedProjectType(ctx);
+  if (recorded !== void 0) return recorded === "obsidian-plugin";
+  const manifest = record(tryParseJson(safeReadText2(join5(repoRoot, "manifest.json"))));
+  return typeof manifest.id === "string" && typeof manifest.minAppVersion === "string";
+}
+function unsupportedVersionTypes(conf, script) {
+  const types = conf.split("\n").map((line) => line.trim().split(/\s+/)[0] ?? "").filter((type) => type && !type.startsWith("#"));
+  return [...new Set(types)].filter((type) => !new RegExp(`(^|[\\s|])${type.replace(/[^a-z0-9-]/gi, "")}(\\|[a-z-]+)*\\)`, "m").test(script));
+}
 var BASE_MISE_PATH_ENTRIES = [".mise/scripts", "agents/hermes/pm"];
 function requiredMisePathEntries(_ctx) {
   return [...BASE_MISE_PATH_ENTRIES];
@@ -9170,8 +9264,9 @@ function projectJsonFinding(ctx) {
   };
 }
 var BMAD_NPM_PACKAGE = "bmad-method";
-var BMAD_INSTALLER_VERSION = "6.12.0";
+var BMAD_INSTALLER_VERSION = "6.12.1";
 var BMAD_TARGET_CHANNEL = "next";
+var BMAD_STABLE_CHANNEL = "latest";
 var BMAD_DIST_TAGS_TTL_MS = 60 * 60 * 1e3;
 var DEFAULT_BMAD_MODULES = ["bmm", "bmb", "cis"];
 var BMAD_INSTALL_TOOLS = SUPPORTED_BMAD_TOOLS;
@@ -9365,10 +9460,17 @@ function runBmadInstall(repoRoot, modules = selectedBmadModules(repoRoot), versi
   const invocation = bmadInstallerInvocation(version);
   const result2 = spawnSync3(invocation.command, [...invocation.prefixArgs, ...bmadInstallerArgs(repoRoot, modules)], { encoding: "utf8" });
   if (result2.status !== 0) {
-    return { ok: false, error: result2.stderr || result2.error?.message || "Unknown error" };
+    const stdoutTail = result2.stdout?.trim().split("\n").slice(-12).join("\n");
+    return { ok: false, error: result2.stderr?.trim() || stdoutTail || result2.error?.message || `installer exited ${result2.status}` };
   }
   return { ok: true };
 }
+function bmadChannelTarget(distTags) {
+  const next = distTags?.[BMAD_TARGET_CHANNEL];
+  const stable = distTags?.[BMAD_STABLE_CHANNEL];
+  if (next && stable && compareBmadVersions(stable, next) > 0) return { version: stable, channel: BMAD_STABLE_CHANNEL };
+  return next ? { version: next, channel: BMAD_TARGET_CHANNEL } : void 0;
+}
 function readInstalledBmadVersion(repoRoot) {
   const raw = safeReadText2(join5(repoRoot, "_bmad", "_config", "manifest.yaml"));
   if (!raw) return void 0;
@@ -10068,6 +10170,15 @@ function createMiseChecks() {
         if (!text2?.includes("# >>> mise-versioning >>>")) details.push("mise versioning managed block missing");
         if (!existsSync3(versioningPath)) details.push(".mise/scripts/versioning.sh missing");
         if (!existsSync3(manifestPath)) details.push(".mise/version-files.conf missing");
+        const conf = safeReadText2(manifestPath);
+        const script = safeReadText2(versioningPath);
+        if (conf !== null && script !== null) {
+          const unsupported = unsupportedVersionTypes(conf, script);
+          if (unsupported.length) details.push(`.mise/scripts/versioning.sh cannot version type(s) ${unsupported.join(", ")} named in .mise/version-files.conf`);
+        }
+        if (conf !== null && isObsidianPluginRepo(ctx, ctx.repoRoot) && !/^obsidian\s+manifest\.json\s*$/m.test(conf)) {
+          details.push(".mise/version-files.conf does not version manifest.json/versions.json for this obsidian-plugin project");
+        }
         return {
           id: "mise.versioning",
           title: "managed mise versioning block",
@@ -10609,6 +10720,15 @@ function strayOpInjectLines(text2) {
   }
   return [...new Set(lines)].sort((a, b) => a - b);
 }
+var COPIER_ANSWERS_HEADER = "# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY";
+function parseCopierAnswers(text2) {
+  try {
+    const parsed = YAML2.parse(text2);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? { answers: parsed } : { problem: ".copier-answers.yml is not a YAML mapping" };
+  } catch (error) {
+    return { problem: `.copier-answers.yml is not valid YAML (${errorText(error).split("\n")[0]})` };
+  }
+}
 function createProjectProvenanceChecks() {
   return [
     {
@@ -10622,16 +10742,14 @@ function createProjectProvenanceChecks() {
         if (!text2) {
           details.push(".copier-answers.yml missing");
         } else {
-          if (!text2.startsWith("# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY")) details.push("missing Copier overwrite warning header");
-          if (!text2.includes("_src_path:")) details.push("_src_path missing");
-          if (project?.project_name) {
-            const nameMatch = text2.match(/project_name:\s*(.+)/);
-            if (!nameMatch || nameMatch[1]?.trim() !== String(project.project_name)) details.push("project_name drift between .copier-answers.yml and .project.json");
-          }
-          if (project?.project_description) {
-            const descMatch = text2.match(/project_description:\s*([\s\S]*?)(?=\n\w|$)/);
-            const yamlDesc = descMatch?.[1]?.replace(/\n\s+/g, " ").trim() ?? "";
-            if (yamlDesc !== String(project.project_description)) details.push("project_description drift between .copier-answers.yml and .project.json");
+          if (!text2.startsWith(COPIER_ANSWERS_HEADER)) details.push("missing Copier overwrite warning header");
+          const parsed = parseCopierAnswers(text2);
+          if ("problem" in parsed) details.push(parsed.problem);
+          else {
+            const { answers } = parsed;
+            if (answers._src_path === void 0) details.push("_src_path missing");
+            if (project?.project_name && String(answers.project_name ?? "") !== String(project.project_name)) details.push("project_name drift between .copier-answers.yml and .project.json");
+            if (project?.project_description && String(answers.project_description ?? "") !== String(project.project_description)) details.push("project_description drift between .copier-answers.yml and .project.json");
           }
         }
         return {
@@ -10646,14 +10764,18 @@ function createProjectProvenanceChecks() {
       migrate: (ctx, finding2) => {
         const changedFiles = [];
         const project = canonicalProjectJson(ctx);
-        const text2 = `# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
-_src_path: ${join5(ctx.pjanglerRoot, "templates", "commonproject")}
-project_description: ${String(project.project_description)}
-project_name: ${String(project.project_name)}
-ticket_provider: ${String(project.ticket_provider?.type ?? "plane")}
-`;
         const path = join5(ctx.repoRoot, ".copier-answers.yml");
-        if (safeReadText2(path) !== text2) {
+        const current = safeReadText2(path);
+        const existing = current ? YAML2.parseDocument(current) : void 0;
+        const document = existing && !existing.errors.length && YAML2.isMap(existing.contents) ? existing : new YAML2.Document({});
+        document.set("_src_path", join5(ctx.pjanglerRoot, "templates", "commonproject"));
+        document.set("project_description", String(project.project_description));
+        document.set("project_name", String(project.project_name));
+        document.set("ticket_provider", String(project.ticket_provider?.type ?? "plane"));
+        const body = String(document);
+        const text2 = body.startsWith(COPIER_ANSWERS_HEADER) ? body : `${COPIER_ANSWERS_HEADER}
+${body}`;
+        if (current !== text2) {
           changedFiles.push(path);
           if (!ctx.dryRun) writeText(path, text2);
         }
@@ -10885,7 +11007,9 @@ function createBmadChecks() {
         }
         const pinned = ctx.bmadVersionPin?.trim();
         const resolved = pinned ? void 0 : resolveBmadDistTags(ctx.homeDir);
-        const available = pinned ?? resolved?.distTags?.[BMAD_TARGET_CHANNEL];
+        const channelTarget = pinned ? void 0 : bmadChannelTarget(resolved?.distTags);
+        const available = pinned ?? channelTarget?.version;
+        const channel = channelTarget?.channel ?? BMAD_TARGET_CHANNEL;
         if (!available) {
           return {
             id: "bmad.version",
@@ -10896,7 +11020,7 @@ function createBmadChecks() {
             fixable: false
           };
         }
-        const targetLabel = pinned ? `pinned ${available}` : `${BMAD_TARGET_CHANNEL} ${available}`;
+        const targetLabel = pinned ? `pinned ${available}` : `${channel} ${available}`;
         const staleNote = resolved?.stale ? `  ${glyph.dot} cached` : "";
         const comparison = compareBmadVersions(installed, available);
         if (pinned ? comparison === 0 : comparison >= 0) {
@@ -10917,7 +11041,7 @@ function createBmadChecks() {
             title: "BMAD version currency",
             status: "skip",
             summary: `BMAD ${installed} installed; stable currency floor unknown (${BMAD_NPM_PACKAGE} latest unresolved)`,
-            details: [`installed: ${installed}`, `available: ${available}  (${BMAD_NPM_PACKAGE}@${BMAD_TARGET_CHANNEL})`],
+            details: [`installed: ${installed}`, `available: ${available}  (${BMAD_NPM_PACKAGE}@${channel})`],
             fixable: false
           };
         }
@@ -10930,7 +11054,7 @@ function createBmadChecks() {
             summary: `BMAD ${installed} is at or ahead of stable ${stable ?? "unknown"}; ${targetLabel} available${staleNote}`,
             details: [
               `installed: ${installed}`,
-              `available: ${available}  (${BMAD_NPM_PACKAGE}@${BMAD_TARGET_CHANNEL})`,
+              `available: ${available}  (${BMAD_NPM_PACKAGE}@${channel})`,
               stable ? `stable latest: ${stable}` : "",
               "run `pj migrate bmad.version` to take the prerelease"
             ].filter(Boolean),
@@ -10944,7 +11068,7 @@ function createBmadChecks() {
           summary: pinnedMismatch ? `BMAD ${installed} does not match ${targetLabel}` : `BMAD ${installed} is behind stable ${stable} \u2014 upgrade available`,
           details: [
             `installed: ${installed}`,
-            pinned ? `required transaction pin: ${available}` : `available: ${available}  (${BMAD_NPM_PACKAGE}@${BMAD_TARGET_CHANNEL})`,
+            pinned ? `required transaction pin: ${available}` : `available: ${available}  (${BMAD_NPM_PACKAGE}@${channel})`,
             !pinned && stable ? `stable latest: ${stable}` : "",
             "run `pj migrate bmad.version` to upgrade"
           ].filter(Boolean),
@@ -10957,13 +11081,13 @@ function createBmadChecks() {
         }
         {
           const current = readInstalledBmadVersion(ctx.repoRoot);
-          const target = ctx.bmadVersionPin?.trim() ?? resolveBmadDistTags(ctx.homeDir)?.distTags?.[BMAD_TARGET_CHANNEL];
+          const target = ctx.bmadVersionPin?.trim() ?? bmadChannelTarget(resolveBmadDistTags(ctx.homeDir)?.distTags)?.version;
           if (!current || !target || compareBmadVersions(current, target) === 0) {
             return { id: finding2.id, title: finding2.title, status: "noop", summary: "BMAD already current", changedFiles: [], details: [] };
           }
         }
         const installed = readInstalledBmadVersion(ctx.repoRoot);
-        const available = ctx.bmadVersionPin?.trim() ?? resolveBmadDistTags(ctx.homeDir)?.distTags?.[BMAD_TARGET_CHANNEL];
+        const available = ctx.bmadVersionPin?.trim() ?? bmadChannelTarget(resolveBmadDistTags(ctx.homeDir)?.distTags)?.version;
         const manifestPath = join5(ctx.repoRoot, "_bmad", "_config", "manifest.yaml");
         const manifestSelection = manifestBmadModules(ctx.repoRoot);
         if (manifestSelection.status === "invalid") {
@@ -17586,18 +17710,18 @@ function reportBoardDelivery(board, slug, skipRequested) {
   log("");
   return skipRequested;
 }
-function projectInitActionLabel(kind) {
-  switch (kind) {
+function projectInitActionLabel(action) {
+  switch (action.kind) {
     case "registry.upsert":
       return "Refresh the project registry index";
     case "copier.copy.commonproject":
-      return "Render CommonProject scaffold";
+      return action.data.project_type && action.data.project_type !== "base" ? `Render CommonProject scaffold (${action.data.project_type})` : "Render CommonProject scaffold";
     case "project.write-manifest":
       return "Write authoritative repo-local .project.json";
     case "ticket-provider.create-or-link":
       return "Create/link ticket provider project";
     default:
-      return kind;
+      return action.kind;
   }
 }
 function registryNeedsUpsert(plan) {
@@ -17622,7 +17746,7 @@ function actionNeedsRun(plan, kind, syncMode) {
 async function selectProjectInitOperations(input) {
   const planOperations = input.plan.actions.filter((action) => actionNeedsRun(input.plan, action.kind, input.syncMode)).map((action) => ({
     value: action.kind,
-    label: projectInitActionLabel(action.kind),
+    label: projectInitActionLabel(action),
     hint: action.kind === "registry.upsert" ? input.plan.registryPath : action.kind
   }));
   const parityOperations = input.auditRules.filter((rule) => rule.fixable && rule.status !== "pass" && rule.status !== "skip").map((rule) => ({
@@ -17742,7 +17866,7 @@ program.configureOutput({
 });
 registerNotebookCli(program);
 program.name("pjangler").description("Project subsystem bootstrapper CLI").version(PJANGLER_VERSION);
-program.command("init").argument("[name]", "Name of a NEW project; creates ./<name>. Omit to adopt the repo you are standing in.").description("Initialize the project manifest, scaffold and registry index").option("--description <text>", "Project description").option("--target-dir <path>", "Adopt an existing repo at this path (the only way to init a directory you are not standing in)").option("--source-skill <path>", "Source skill/template provenance path").option("--primary-language <language>", "Primary language for CommonProject rendering", "python").option("--apply", "Write the project manifest, render the scaffold and refresh its index").option("--dry-run", "Preview changes without writing files (default)").option("--live", "Allow host-level external effects (systemd, notebook reconcile). The ticket board is created by default and does not need this.").option("--id <project-id>", "Canonical project ID (case-insensitive)").addOption(new Option("--slug <slug>", "Legacy alias for --id").hideHelp()).option("--identifier <identifier>", "Provider ticket prefix (board metadata)").option("--ticket-provider <type>", "Ticket provider: plane | trello (default: existing binding or plane)").option("--board-id <id>", "Board id (Plane project UUID or Trello board id)").option("--board-url <url>", "Deprecated no-op; board URLs are derived from provider + workspace + board-id").option("--skip-board", "Do not create or link a ticket board (the record stays unlinked, and init says so)").option("--workspace <name>", "Ticket workspace/org (Plane workspace; blank for Trello)").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("-f, --force", "Allow replacing an existing registry entry, re-rendering files, and renaming an already-registered project").option("-y, --yes", "Apply every proposed operation without prompting").option("--no-tui", "Disable interactive prompts").option("--json", "Output machine-parseable JSON").action(async (name, options) => {
+program.command("init").argument("[name]", "Name of a NEW project; creates ./<name>. Omit to adopt the repo you are standing in.").description("Initialize the project manifest, scaffold and registry index").option("--description <text>", "Project description").option("--target-dir <path>", "Adopt an existing repo at this path (the only way to init a directory you are not standing in)").option("--source-skill <path>", "Source skill/template provenance path").option("--primary-language <language>", "Primary language recorded for the project (default: the recorded one, else the project type's, else python)").option("--obsidian-plugin", "Render the CommonProject variant built on the canonical Obsidian sample plugin (new projects; on an existing repo, records one that already is a plugin)").option("--apply", "Write the project manifest, render the scaffold and refresh its index").option("--dry-run", "Preview changes without writing files (default)").option("--live", "Allow host-level external effects (systemd, notebook reconcile). The ticket board is created by default and does not need this.").option("--id <project-id>", "Canonical project ID (case-insensitive)").addOption(new Option("--slug <slug>", "Legacy alias for --id").hideHelp()).option("--identifier <identifier>", "Provider ticket prefix (board metadata)").option("--ticket-provider <type>", "Ticket provider: plane | trello (default: existing binding or plane)").option("--board-id <id>", "Board id (Plane project UUID or Trello board id)").option("--board-url <url>", "Deprecated no-op; board URLs are derived from provider + workspace + board-id").option("--skip-board", "Do not create or link a ticket board (the record stays unlinked, and init says so)").option("--workspace <name>", "Ticket workspace/org (Plane workspace; blank for Trello)").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("-f, --force", "Allow replacing an existing registry entry, re-rendering files, and renaming an already-registered project").option("-y, --yes", "Apply every proposed operation without prompting").option("--no-tui", "Disable interactive prompts").option("--json", "Output machine-parseable JSON").action(async (name, options) => {
   if (name && getRecipeNames().includes(name)) {
     if (!options.json) {
       console.error(`${yellow(glyph.warn)} ${dim(`"pjangler init ${name}" is deprecated \u2014 use "pjangler add ${name}". Forwarding\u2026`)}`);
@@ -17865,7 +17989,7 @@ boardCmd.command("modules").description("List this project's modules").option("-
   }
 });
 var projectCmd = program.command("project", { hidden: true }).description("Legacy aliases for project commands");
-projectCmd.command("init").argument("[name]", "Project display name").description("Plan or apply a registry-backed CommonProject initialization or legacy repo sync").option("--description <text>", "Project description").option("--target-dir <path>", "Adopt an existing repo at this path (the only way to init a directory you are not standing in)").option("--source-skill <path>", "Source skill/template provenance path").option("--primary-language <language>", "Primary language for CommonProject rendering", "python").option("--apply", "Write the project manifest, render the scaffold and refresh its index").option("--dry-run", "Preview changes without writing files (default)").option("--live", "Allow host-level external effects (systemd, notebook reconcile). The ticket board is created by default and does not need this.").option("--id <project-id>", "Canonical project ID (case-insensitive)").addOption(new Option("--slug <slug>", "Legacy alias for --id").hideHelp()).option("--identifier <identifier>", "Provider ticket prefix (board metadata)").option("--ticket-provider <type>", "Ticket provider: plane | trello (default: existing binding or plane)").option("--board-id <id>", "Board id (Plane project UUID or Trello board id)").option("--board-url <url>", "Deprecated no-op; board URLs are derived from provider + workspace + board-id").option("--skip-board", "Do not create or link a ticket board (the record stays unlinked, and init says so)").option("--workspace <name>", "Ticket workspace/org (Plane workspace; blank for Trello)").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("-f, --force", "Allow replacing an existing registry entry, re-rendering files, and renaming an already-registered project").option("-y, --yes", "Apply every proposed operation without prompting").option("--no-tui", "Disable interactive prompts").option("--json", "Output machine-parseable JSON").action((name, options) => {
+projectCmd.command("init").argument("[name]", "Project display name").description("Plan or apply a registry-backed CommonProject initialization or legacy repo sync").option("--description <text>", "Project description").option("--target-dir <path>", "Adopt an existing repo at this path (the only way to init a directory you are not standing in)").option("--source-skill <path>", "Source skill/template provenance path").option("--primary-language <language>", "Primary language recorded for the project (default: the recorded one, else the project type's, else python)").option("--obsidian-plugin", "Render the CommonProject variant built on the canonical Obsidian sample plugin (new projects; on an existing repo, records one that already is a plugin)").option("--apply", "Write the project manifest, render the scaffold and refresh its index").option("--dry-run", "Preview changes without writing files (default)").option("--live", "Allow host-level external effects (systemd, notebook reconcile). The ticket board is created by default and does not need this.").option("--id <project-id>", "Canonical project ID (case-insensitive)").addOption(new Option("--slug <slug>", "Legacy alias for --id").hideHelp()).option("--identifier <identifier>", "Provider ticket prefix (board metadata)").option("--ticket-provider <type>", "Ticket provider: plane | trello (default: existing binding or plane)").option("--board-id <id>", "Board id (Plane project UUID or Trello board id)").option("--board-url <url>", "Deprecated no-op; board URLs are derived from provider + workspace + board-id").option("--skip-board", "Do not create or link a ticket board (the record stays unlinked, and init says so)").option("--workspace <name>", "Ticket workspace/org (Plane workspace; blank for Trello)").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("-f, --force", "Allow replacing an existing registry entry, re-rendering files, and renaming an already-registered project").option("-y, --yes", "Apply every proposed operation without prompting").option("--no-tui", "Disable interactive prompts").option("--json", "Output machine-parseable JSON").action((name, options) => {
   if (!options.json) console.error(`${yellow(glyph.warn)} ${dim('"pjangler project init" is deprecated \u2014 use "pjangler init".')}`);
   return runProjectInit(name, options);
 });
@@ -17880,6 +18004,7 @@ async function runProjectInit(name, options) {
       targetDir: target.targetDir,
       sourceSkill: options.sourceSkill,
       primaryLanguage: options.primaryLanguage,
+      projectType: options.obsidianPlugin ? "obsidian-plugin" : void 0,
       apply,
       live: options.live ?? false,
       projectSlug: target.slug,
@@ -17968,6 +18093,14 @@ async function runProjectInit(name, options) {
       if (result2.ok && result2.changedFiles.length) console.log(`  ${green(glyph.pass)} ${bold("Project synchronized")}  ${dim(glyph.dot)}  ${cyan(plan.project.slug)}`);
       if (result2.ok && result2.changedFiles.length === 0) console.log(`  ${green(glyph.pass)} ${dim("Already in parity")}  ${dim(glyph.dot)}  ${cyan(plan.project.slug)}`);
       reportBoardDelivery(board, plan.project.slug, skipRequested);
+      const rendered = selectedPlan.actions.find((action) => action.kind === "copier.copy.commonproject");
+      if (result2.ok && rendered?.kind === "copier.copy.commonproject" && rendered.data.project_type === "obsidian-plugin") {
+        console.log(`  ${bold("Next")}  ${dim(`cd ${target.targetDir}`)}`);
+        console.log(`     ${cyan("npm install")} ${dim("dev dependencies, pinned by the committed package-lock.json")}`);
+        console.log(`     ${cyan("npm run dev")} ${dim("watch build -> main.js")}`);
+        console.log(`     ${cyan("mise run plugin:link <vault>")} ${dim("load it in an Obsidian vault")}`);
+        console.log("");
+      }
     }
     process.exitCode = result2.ok && boardDelivered ? 0 : 1;
   } catch (err) {