@delorenj/pjangler 1.5.11 → 1.5.12

package/dist/mcp-server.js

@@ -828,6 +828,38 @@ import { homedir as homedir3, tmpdir as tmpdir2 } from "node:os";
 import { basename as basename6, delimiter as delimiter2, dirname as dirname10, isAbsolute as isAbsolute5, join as join11, relative as relative7, resolve as resolve9, 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 text = typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (PROJECT_TYPES.includes(text)) return text;
+  throw new Error(`${label} ${JSON.stringify(value)} is not one of: ${PROJECT_TYPES.join(", ")}`);
+}
+function looksLikeObsidianPlugin(dir) {
+  try {
+    const manifest = JSON.parse(readFileSync8(join11(dir, "manifest.json"), "utf8"));
+    return isRecord2(manifest) && typeof manifest.id === "string" && typeof manifest.minAppVersion === "string";
+  } catch {
+    return false;
+  }
+}
+function assertTemplateOffersProjectType(pjanglerRoot, projectType) {
+  if (projectType === "base") return;
+  const copierYml = join11(pjanglerRoot, "templates", "commonproject", "copier.yml");
+  let choices;
+  try {
+    const parsed = YAML4.parse(readFileSync8(copierYml, "utf8"));
+    choices = isRecord2(parsed) && isRecord2(parsed.project_type) ? parsed.project_type.choices : void 0;
+  } catch {
+    choices = void 0;
+  }
+  const offered = isRecord2(choices) ? Object.values(choices) : Array.isArray(choices) ? choices : [];
+  if (!offered.includes(projectType)) {
+    throw new Error(`The CommonProject template at ${dirname10(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 = spawnSync4("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());
 }
@@ -1431,6 +1463,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(join11(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,
@@ -1452,7 +1504,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({
@@ -1488,6 +1543,7 @@ function planProjectInit(input) {
     { kind: "registry.upsert", registryPath, slug, project }
   ];
   if (scaffold) {
+    assertTemplateOffersProjectType(pjanglerRoot, projectType);
     actions.push(buildCommonProjectCopierAction({
       pjanglerRoot,
       targetDir,
@@ -1501,6 +1557,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
     }));
@@ -1639,6 +1697,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(join11(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) || readFileSync8(action.path, "utf8") !== action.expectedContent)) {
         errors.push(`Manifest changed after planning: ${action.path}; re-plan before applying`);
@@ -1771,6 +1836,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"];
@@ -1871,7 +1938,7 @@ function expandHome(path) {
 function isRecord2(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";
@@ -1887,6 +1954,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", join11("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"];
@@ -7678,9 +7752,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];
@@ -8884,6 +8973,15 @@ function createMiseChecks() {
         if (!text?.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",
@@ -9425,6 +9523,15 @@ function strayOpInjectLines(text) {
   }
   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(text) {
+  try {
+    const parsed = YAML2.parse(text);
+    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 [
     {
@@ -9438,16 +9545,14 @@ function createProjectProvenanceChecks() {
         if (!text) {
           details.push(".copier-answers.yml missing");
         } else {
-          if (!text.startsWith("# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY")) details.push("missing Copier overwrite warning header");
-          if (!text.includes("_src_path:")) details.push("_src_path missing");
-          if (project?.project_name) {
-            const nameMatch = text.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 = text.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 (!text.startsWith(COPIER_ANSWERS_HEADER)) details.push("missing Copier overwrite warning header");
+          const parsed = parseCopierAnswers(text);
+          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 {
@@ -9462,14 +9567,18 @@ function createProjectProvenanceChecks() {
       migrate: (ctx, finding2) => {
         const changedFiles = [];
         const project = canonicalProjectJson(ctx);
-        const text = `# 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) !== text) {
+        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 text = body.startsWith(COPIER_ANSWERS_HEADER) ? body : `${COPIER_ANSWERS_HEADER}
+${body}`;
+        if (current !== text) {
           changedFiles.push(path);
           if (!ctx.dryRun) writeText(path, text);
         }
@@ -14427,6 +14536,7 @@ var server = new McpServer({
   version: PJANGLER_VERSION
 });
 var TICKET_PROVIDER_SCHEMA = z.enum(["plane", "trello"]);
+var PROJECT_TYPE_SCHEMA = z.enum(PROJECT_TYPES).describe("What CommonProject renders: base (default) or obsidian-plugin. Fixed at creation; omit it to keep the recorded type.");
 var BOARD_URL_COMPAT_SCHEMA = z.string().optional().describe("Deprecated compatibility input. Ignored; board URLs are derived at runtime and are never persisted.").meta({ deprecated: true });
 var RUNTIME_REPO_COMPAT_SCHEMA = z.boolean().optional().describe("Deprecated no-op. Hermes always converges ignored role-local runtime state and never provisions a per-agent GitHub repository.").meta({ deprecated: true });
 function safePathSegmentSchema(label) {
@@ -14748,6 +14858,7 @@ server.registerTool(
       planeProjectId: z.string().optional(),
       projectIdentifier: z.string().optional(),
       primaryLanguage: z.string().optional(),
+      projectType: PROJECT_TYPE_SCHEMA.optional(),
       skipPlane: z.boolean().optional(),
       agentPurpose: z.string().optional(),
       local: z.boolean().optional(),
@@ -14792,7 +14903,8 @@ server.registerTool(
         targetDir,
         projectSlug,
         sourceSkill: input.sourceSkill,
-        primaryLanguage: input.primaryLanguage ?? "python",
+        primaryLanguage: input.primaryLanguage,
+        projectType: input.projectType,
         apply: !dryRun,
         live: input.live ?? false,
         provisionTicketBoard: externalEffects.ticketBoard,
@@ -14857,6 +14969,7 @@ server.registerTool(
       targetDir: z.string().optional(),
       sourceSkill: z.string().optional(),
       primaryLanguage: z.string().optional(),
+      projectType: PROJECT_TYPE_SCHEMA.optional(),
       apply: z.boolean().optional(),
       live: z.boolean().optional(),
       provisionTicketBoard: z.boolean().optional().describe("Explicitly opt in to ticket-board provisioning; also requires live=true and skipPlane!=true."),
@@ -14880,6 +14993,7 @@ server.registerTool(
         targetDir: input.targetDir,
         sourceSkill: input.sourceSkill,
         primaryLanguage: input.primaryLanguage,
+        projectType: input.projectType,
         apply: input.apply ?? false,
         live: input.live ?? false,
         provisionTicketBoard: externalEffects.ticketBoard,

package/dist/notebook/journal-service-main.js

@@ -660,7 +660,7 @@ function validateProjectRecord(project, key) {
 function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var PROJECT_REGISTRY_SCHEMA_VERSION, 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_REGISTRY_SCHEMA_VERSION, PROJECT_TYPE_SENTINELS, 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";
@@ -673,6 +673,9 @@ var init_project = __esm({
     init_boardQuery();
     init_registryClient();
     PROJECT_REGISTRY_SCHEMA_VERSION = 1;
+    PROJECT_TYPE_SENTINELS = {
+      "obsidian-plugin": ["manifest.json", join2("src", "main.ts")]
+    };
     PROJECT_IDENTIFIER_SOURCES = ["provider", "proposed"];
     IDENTIFIER_ASSIGNING_PROVIDERS = ["plane", "linear"];
     TICKET_PROVIDER_STATES = ["planned", "linked", "skipped"];

package/dist/project-registry-service.js

@@ -234,7 +234,7 @@ function validateManifestFields(manifest, path) {
     if (!object(manifest.template.commonproject)) fail("template.commonproject", "an object");
     const template = manifest.template.commonproject;
     if (template.enabled !== void 0 && typeof template.enabled !== "boolean") fail("template.commonproject.enabled", "boolean");
-    strings(template, ["primary_language"], "template.commonproject.");
+    strings(template, ["primary_language", "project_type"], "template.commonproject.");
   }
   for (const field of ["binding", "policy"]) if (manifest.notebook?.[field] !== void 0 && !object(manifest.notebook[field])) fail(`notebook.${field}`, "an object");
   if (manifest.notebook?.binding) strings(manifest.notebook.binding, ["provider", "state", "notebook_name", "blocked_reason", "notebook_id", "overview_note_id", "created_at", "updated_at"], "notebook.binding.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/pjangler",
-  "version": "1.5.11",
+  "version": "1.5.12",
   "description": "Project subsystem bootstrapper CLI",
   "type": "module",
   "main": "dist/index.js",

package/templates/commonproject/copier.yml

@@ -43,6 +43,30 @@ ticket_provider:
     Plane: plane
     Trello: trello
 
+# What this project is. `base` is the generic skeleton below and nothing else.
+# `obsidian-plugin` (`pj init --obsidian-plugin`) adds an Obsidian community
+# plugin on top of it, vendored from the canonical starter
+# obsidianmd/obsidian-sample-plugin @ 07ceb81d (2026-08-02): npm + esbuild +
+# TypeScript, manifest.json/versions.json, eslint-plugin-obsidianmd, and its
+# build/release workflows moved to the self-hosted runners.
+#
+# Every type-only path under template/ carries `{% if is_obsidian_plugin %}`
+# in its NAME (directories included), so it does not exist in a base render.
+# Never name one a bare `.gitignore`/`.npmrc`: npm pack drops those from the
+# published pjangler tarball.
+#
+# A real question on purpose, not `when: false`. Copier records only asked
+# questions in .copier-answers.yml; a hidden type would be forgotten, and a
+# re-copy would silently re-render the shared files as `base`. `--defaults`
+# never prompts for it, and pjangler always passes it with --data.
+project_type:
+  type: str
+  help: What kind of project is this?
+  default: base
+  choices:
+    CommonProject base: base
+    Obsidian community plugin: obsidian-plugin
+
 # --- Derived (never asked) ---
 
 project_slug:
@@ -50,6 +74,70 @@ project_slug:
   default: "{{ project_name | lower | replace(' ', '-') | replace('_', '-') }}"
   when: false
 
+is_obsidian_plugin:
+  type: bool
+  default: "{{ project_type == 'obsidian-plugin' }}"
+  when: false
+
+# Obsidian manifest identity (obsidian-plugin only). The catalog rejects a
+# plugin id or name containing "obsidian" and frowns on a trailing "plugin",
+# and the id must equal the plugin's folder name in a vault, so both are the
+# project's own identity with those affixes dropped:
+# "obsidian-tag-wrangler" -> id "tag-wrangler".
+plugin_id:
+  type: str
+  default: >-
+    {%- set id = project_slug | lower | regex_replace('[^a-z0-9-]+', '-') | replace('obsidian', '') | regex_replace('-+', '-') -%}
+    {%- set id = id.strip('-') -%}
+    {%- if id.endswith('-plugin') %}{% set id = id[:-7] %}{% endif -%}
+    {{ id or 'plugin' }}
+  when: false
+
+# A slug-style project name ("obsidian-tag-wrangler") reads as words in the
+# Obsidian UI: separators become spaces and an all-lowercase name is
+# title-cased ("Tag Wrangler"); a name with its own casing keeps it.
+plugin_name:
+  type: str
+  default: >-
+    {%- set name = project_name | regex_replace('(?i)obsidian', ' ') | regex_replace('[-_:.]+', ' ') | regex_replace('\\s+', ' ') | trim -%}
+    {%- set name = name | regex_replace('(?i)\\s*\\bplugin$', '') | trim -%}
+    {%- if name == name | lower %}{% set name = name | title %}{% endif -%}
+    {{ name or project_name }}
+  when: false
+
+# TypeScript identifier stem for src/: "tag-wrangler" -> TagWranglerPlugin,
+# TagWranglerSettings, TagWranglerSettingTab, TagWranglerModal. The starter's
+# own names (MyPlugin, SampleModal, ...) fail eslint-plugin-obsidianmd's
+# sample-names rule, and a "Plugin" stem would declare PluginSettingTab over
+# Obsidian's own, so those stems get a "Project" suffix.
+plugin_class:
+  type: str
+  default: >-
+    {%- set ns = namespace(name='') -%}
+    {%- for word in plugin_id.replace('_', '-').replace('.', '-').split('-') -%}
+    {%- set ns.name = ns.name ~ (word | capitalize) -%}
+    {%- endfor -%}
+    {%- if not ns.name or ns.name[0] in '0123456789' %}{% set ns.name = 'Plugin' ~ ns.name %}{% endif -%}
+    {%- if ns.name in ['My', 'Sample', 'Plugin'] %}{% set ns.name = ns.name ~ 'Project' %}{% endif -%}
+    {{ ns.name }}
+  when: false
+
+# The catalog wants a sentence: it must end in punctuation.
+plugin_description:
+  type: str
+  default: >-
+    {%- set text = project_description | trim -%}
+    {%- if text and text[-1] not in '.?!)' %}{% set text = text ~ '.' %}{% endif -%}
+    {{ text or 'Describe what this plugin does.' }}
+  when: false
+
+# pjangler passes the operator's git user.name; a bare copier render leaves it
+# for the author to fill in.
+plugin_author:
+  type: str
+  default: ""
+  when: false
+
 # Board binding — supplied by init-project.sh's --data-file after the board is
 # created. Defaults keep a bare `copier copy` rendering valid (empty binding).
 plane_workspace:
@@ -111,6 +199,19 @@ _skip_if_exists:
   # Selection is project intent, not generated output. A refresh must preserve
   # inheritance choices, exclusions, and active packs byte-for-byte.
   - ".agents/skills.json"
+  # obsidian-plugin seed files: rendered once at creation, owned by the plugin
+  # after that. A forced re-render must not reset a bumped manifest version or
+  # replace real plugin code with the sample. (Paths a base render never
+  # produces, so this is inert for base projects.)
+  - "package.json"
+  - "package-lock.json"
+  - "manifest.json"
+  - "versions.json"
+  - "styles.css"
+  - "tsconfig.json"
+  - "esbuild.config.mjs"
+  - "eslint.config.mts"
+  - "src/**"
 
 # --- Post-generation tasks ---
 #
@@ -124,7 +225,7 @@ _tasks:
   # byte and append only the small CommonProject-owned contract when absent.
   # Machine-local backup/editor/CLI exclusions belong in the user's global
   # ignore; `.agents/` is the sole canonical agent-config tree in Git.
-  - "touch .gitignore; if [ -s .gitignore ] && [ -n \"$(tail -c 1 .gitignore)\" ]; then printf '\\n' >> .gitignore; fi; grep -Fqx '# CommonProject repository contract' .gitignore 2>/dev/null || printf '%s\\n' '# CommonProject repository contract' >> .gitignore; for pattern in '.env' '.env.*' '!.env.op' '/.agents/local.json' '/.agents/skills'; do grep -Fqx -- \"$pattern\" .gitignore 2>/dev/null || printf '%s\\n' \"$pattern\" >> .gitignore; done"
+  - "touch .gitignore; if [ -s .gitignore ] && [ -n \"$(tail -c 1 .gitignore)\" ]; then printf '\\n' >> .gitignore; fi; grep -Fqx '# CommonProject repository contract' .gitignore 2>/dev/null || printf '%s\\n' '# CommonProject repository contract' >> .gitignore; for pattern in '.env' '.env.*' '!.env.op' '/.agents/local.json' '/.agents/skills'{% if is_obsidian_plugin %} 'node_modules/' '/main.js' '*.map' '/data.json'{% endif %}; do grep -Fqx -- \"$pattern\" .gitignore 2>/dev/null || printf '%s\\n' \"$pattern\" >> .gitignore; done"
   # PJAN-82: use the managed script, which refuses to replace a REAL CLAUDE.md.
   # `ln -sf` cannot distinguish a stale link it owns from a hand-written file it
   # must not touch, so a re-render into a live project destroyed the file and

package/templates/commonproject/template/.github/workflows/{% if is_obsidian_plugin %}lint.yml{% endif %}

@@ -0,0 +1,29 @@
+# Build + lint the Obsidian plugin on every push and pull request.
+#
+# Adapted from obsidianmd/obsidian-sample-plugin's lint.yml. The one deliberate
+# change is the runner: self-hosted on big-chungus, never a GitHub-hosted label.
+# Hosted minutes are billed on private repos and the budget is $0. A
+# personal-account repo needs its own repo-level runner (delonet-conventions
+# skill, references/ci-runners.md).
+name: Plugin build
+
+on:
+    push:
+        branches: ['**']
+    pull_request:
+        branches: ['**']
+
+jobs:
+    build:
+        runs-on: [self-hosted, Linux, delonet]
+
+        steps:
+            - uses: actions/checkout@v6
+            - name: Use Node.js 24
+              uses: actions/setup-node@v6
+              with:
+                  node-version: 24
+                  cache: 'npm'
+            - run: npm ci
+            - run: npm run build --if-present
+            - run: npm run lint

package/templates/commonproject/template/.github/workflows/{% if is_obsidian_plugin %}release.yml{% endif %}

@@ -0,0 +1,62 @@
+# Draft a GitHub release for every pushed tag.
+#
+# Adapted from obsidianmd/obsidian-sample-plugin's release.yml. Changes:
+#   - self-hosted runner (see lint.yml for why);
+#   - build provenance is attested only on public repos. GitHub refuses
+#     artifact attestations on user-owned private repos, and an Obsidian plugin
+#     only has to be public once it is submitted to the community catalog.
+#
+# Tag with the bare manifest version (`npm version patch` does this — .npmrc
+# sets tag-version-prefix=""), never a leading `v`: Obsidian matches the release
+# tag against manifest.json's version.
+name: Release Obsidian plugin
+
+on:
+    push:
+        tags:
+            - '*'
+
+jobs:
+    build:
+        runs-on: [self-hosted, Linux, delonet]
+        permissions:
+            contents: write
+            id-token: write
+            attestations: write
+        steps:
+            - uses: actions/checkout@v6
+
+            - name: Use Node.js
+              uses: actions/setup-node@v6
+              with:
+                  node-version: 24
+                  cache: 'npm'
+
+            - name: Build plugin
+              run: |
+                  npm ci
+                  npm run build
+
+            - name: Check for optional styles
+              id: styles
+              run: |
+                  [ -f styles.css ] && echo "exists=true" >> "$GITHUB_OUTPUT" || echo "exists=false" >> "$GITHUB_OUTPUT"
+
+            - name: Attest build provenance
+              if: ${{ !github.event.repository.private }}
+              uses: actions/attest@v4
+              with:
+                  subject-path: |
+                      main.js
+                      ${{ steps.styles.outputs.exists == 'true' && 'styles.css' || '' }}
+
+            - name: Create release
+              env:
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  tag="${GITHUB_REF#refs/tags/}"
+
+                  gh release create "$tag" \
+                    --title="$tag" \
+                    --draft \
+                    main.js manifest.json ${{ steps.styles.outputs.exists == 'true' && 'styles.css' || '' }}

package/templates/commonproject/template/.mise/{% if is_obsidian_plugin %}tasks{% endif %}/plugin/link

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#MISE description="Symlink this plugin into an Obsidian vault: plugin:link [vault] (default: $OBSIDIAN_VAULT)"
+#MISE tools={node="24"}
+# Obsidian loads a plugin from <vault>/.obsidian/plugins/<manifest id>/, reading
+# main.js, manifest.json and styles.css. Linking the repo there means every
+# `npm run dev` rebuild is live after a plugin reload (or instantly with the
+# Hot-Reload community plugin). Replaces only a symlink it can recognise as a
+# link; a real directory at the destination is left alone.
+set -euo pipefail
+
+root="${MISE_CONFIG_ROOT:-$(pwd)}"
+vault="${1:-${OBSIDIAN_VAULT:-}}"
+[ -n "$vault" ] || { echo "plugin:link: pass the vault path or set OBSIDIAN_VAULT" >&2; exit 2; }
+[ -d "$vault/.obsidian" ] || { echo "plugin:link: $vault is not an Obsidian vault (no .obsidian/)" >&2; exit 2; }
+
+id="$(node -p 'JSON.parse(require("fs").readFileSync(process.argv[1], "utf8")).id' "$root/manifest.json")"
+[ -n "$id" ] || { echo "plugin:link: manifest.json has no id" >&2; exit 1; }
+
+dest="$vault/.obsidian/plugins/$id"
+if [ -e "$dest" ] && [ ! -L "$dest" ]; then
+  echo "plugin:link: $dest already exists and is not a symlink; remove it first" >&2
+  exit 1
+fi
+mkdir -p "$vault/.obsidian/plugins"
+ln -sfn "$root" "$dest"
+echo "linked $dest -> $root"
+[ -f "$root/main.js" ] || echo "plugin:link: no main.js yet; run npm run dev (or npm run build)" >&2

package/templates/commonproject/template/AGENTS.md.jinja

@@ -5,3 +5,70 @@
 ## Overview
 
 __TODO__
+{%- if is_obsidian_plugin %}
+
+## Obsidian community plugin
+
+This project is an Obsidian community plugin, scaffolded from the canonical
+[obsidian-sample-plugin](https://github.com/obsidianmd/obsidian-sample-plugin).
+TypeScript in `src/` is bundled by esbuild into `main.js`, which Obsidian loads.
+
+- Package manager: **npm** (`package.json` scripts, `package-lock.json`). Never bun or pnpm.
+- Bundler: **esbuild** (`esbuild.config.mjs`). Types come from the `obsidian` package.
+- Release artifacts: `main.js`, `manifest.json`, and `styles.css` (optional).
+
+### Commands
+
+```bash
+npm install          # dev dependencies, pinned by the committed package-lock.json
+npm run dev          # watch build -> main.js (inline sourcemaps)
+npm run build        # type-check, then production build
+npm run lint         # eslint with eslint-plugin-obsidianmd
+mise run plugin:link # symlink this repo into $OBSIDIAN_VAULT/.obsidian/plugins/<id>
+```
+
+Reload Obsidian (or use the Hot-Reload plugin) and enable the plugin under
+**Settings → Community plugins**.
+
+### Layout
+
+- `src/main.ts` stays small: plugin lifecycle (`onload`/`onunload`) and registration only.
+- Feature logic goes in focused modules under `src/` (`settings.ts`, `commands/`, `ui/`, `utils/`).
+- Never commit `node_modules/`, `main.js`, `*.map`, or the vault's `data.json`.
+- Bundle every runtime dependency into `main.js`; keep dependencies small and browser-compatible.
+
+### Manifest rules (`manifest.json`)
+
+- `id` is stable API: never change it after release. It must not contain "obsidian",
+  and for local development it must match the plugin folder name in the vault.
+- `version` is SemVer `x.y.z`; keep `minAppVersion` accurate when you use newer APIs.
+- `isDesktopOnly` must be `true` if you use Node or Electron APIs.
+- Canonical checks: https://github.com/obsidianmd/obsidian-releases/blob/master/.github/workflows/validate-plugin-entry.yml
+
+### Versioning and releases
+
+- `npm version patch|minor|major` is the release step. It bumps `package.json`, and
+  `version-bump.mjs` syncs `manifest.json` and `versions.json` (plugin version → minimum
+  app version). It commits, then tags the bare version: no leading `v`, because `.npmrc`
+  sets `tag-version-prefix=""`.
+- `mise run version:bump` keeps the same three files in step without committing or tagging.
+- Push the tag. `.github/workflows/release.yml` drafts the GitHub release with `main.js`,
+  `manifest.json` and `styles.css` attached.
+- The community catalog requires a public repo and a LICENSE; pick one before submitting.
+
+### Plugin conventions
+
+- Add commands with `this.addCommand(...)` and stable IDs; never rename a released ID.
+- Persist settings with `this.loadData()` / `this.saveData()`, with defaults in `settings.ts`.
+- Register every DOM event, workspace event, and interval through `this.register*`,
+  so the plugin unloads without leaking listeners.
+- Keep `onload` light: defer heavy work, debounce vault events, batch disk access.
+- Stay inside the vault, make no network calls without a user-visible reason, and never
+  fetch or eval remote code. These are Obsidian's developer policies, and review enforces them.
+- UI copy uses sentence case, short imperative labels, and **Settings → Community plugins**
+  style arrow navigation.
+
+References: [API docs](https://docs.obsidian.md) ·
+[Plugin guidelines](https://docs.obsidian.md/Plugins/Releasing/Plugin+guidelines) ·
+[Developer policies](https://docs.obsidian.md/Developer+policies)
+{%- endif %}