baller-maester 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-05-14
+
+### Added
+- **`maester publish` per-document state prompt** — the publish walkthrough now asks per published document for a state choice: `draft`, `canon`, or "file header" (defer to inline state in the file). `draft` / `canon` are persisted as a `state:` field on the document entry in `maester.yaml`; "file header" omits the field so each file's own inline state (or the default `draft`) governs at sync time. Covers both the README.md auto-add path and explicit per-document additions, mirroring the `maester init` prompt added in v0.2.0.
+
 ## [0.2.1] - 2026-05-14
 
 ### Fixed

package/dist/cli/main.js

@@ -1172,7 +1172,7 @@ function dedupeTargets(targets) {
 
 // package.json
 var package_default = {
-  version: "0.2.1"};
+  version: "0.3.0"};
 var PACKAGE_VERSION = package_default.version;
 
 // src/core/skill/version.ts
@@ -1702,6 +1702,25 @@ function parseTags(value) {
 }
 
 // src/cli/commands/publish.ts
+function buildPublishedDocumentStateField(choice) {
+  if (choice === "file-header") return {};
+  return { state: choice };
+}
+async function askDocumentState(ctx, path5) {
+  return ctx.prompts.select({
+    message: `State for '${path5}'?`,
+    initialValue: "file-header",
+    options: [
+      { value: "draft", label: "draft", hint: "tag this entry as draft" },
+      { value: "canon", label: "canon", hint: "tag this entry as canon" },
+      {
+        value: "file-header",
+        label: "file header",
+        hint: "no rule; defer to inline state in the file"
+      }
+    ]
+  });
+}
 function registerPublish(program, getContext) {
   program.command("publish").description("Configure this repository as a maester (walkthrough).").action(async () => {
     await runPublish(getContext());
@@ -1725,7 +1744,12 @@ async function runPublish(ctx) {
       initialValue: true
     });
     if (useReadme) {
-      documents.push({ path: "README.md", category: "readme" });
+      const stateChoice = await askDocumentState(ctx, "README.md");
+      documents.push({
+        path: "README.md",
+        category: "readme",
+        ...buildPublishedDocumentStateField(stateChoice)
+      });
       ctx.prompts.log.success("Added README.md");
     }
   }
@@ -1794,6 +1818,7 @@ async function collectOneDocument(ctx, repoRoot, existing) {
       ctx.prompts.log.warning(`'${trimmed}' does not yet exist in this repo. Saving anyway.`);
     }
   }
+  const stateChoice = await askDocumentState(ctx, trimmed);
   const description = await ctx.prompts.text({
     message: "Description (optional)",
     placeholder: ""
@@ -1821,7 +1846,8 @@ async function collectOneDocument(ctx, repoRoot, existing) {
     path: trimmed,
     ...trimmedDesc ? { description: trimmedDesc } : {},
     ...trimmedCat ? { category: trimmedCat } : {},
-    ...tags.length > 0 ? { tags } : {}
+    ...tags.length > 0 ? { tags } : {},
+    ...buildPublishedDocumentStateField(stateChoice)
   };
   return doc;
 }