baller-maester 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ 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
+- **npm publish provenance** — added `repository`, `bugs`, and `homepage` fields to `package.json` so sigstore provenance validation matches the GitHub repository URL. Without these, `npm publish --provenance` failed with `422 Unprocessable Entity` because `repository.url` defaulted to an empty string.
+
+## [0.2.0] - 2026-05-14
+
+### Added
+- **`maester init` per-entry state prompt** — when the user declares an explicit `includes` list during citadel initialization, the walkthrough now asks per entry for a state choice: `draft`, `canon`, or "file header" (defer to inline state in the file). `draft` / `canon` are persisted as the enriched `{ path, state }` object form in `citadel.yaml`; "file header" keeps the bare-string form so each file's own inline state (or the default `draft`) governs at sync time. Manifest-driven sources are unaffected.
+
 ## [0.1.0] - 2026-05-13
 
 ### Added

package/dist/cli/main.js

@@ -1172,7 +1172,7 @@ function dedupeTargets(targets) {
 
 // package.json
 var package_default = {
-  version: "0.1.0"};
+  version: "0.3.0"};
 var PACKAGE_VERSION = package_default.version;
 
 // src/core/skill/version.ts
@@ -1546,16 +1546,39 @@ async function collectIncludes(ctx) {
     message: "Includes \u2014 repo-relative paths or globs, comma- or whitespace-separated. At least one required.",
     placeholder: "docs/**/*.md, README.md",
     validate: (value) => {
-      const entries = parseIncludesEntries(value);
-      if (entries.length === 0) return "At least one includes entry is required.";
-      for (const entry of entries) {
+      const entries2 = parseIncludesEntries(value);
+      if (entries2.length === 0) return "At least one includes entry is required.";
+      for (const entry of entries2) {
         const result = validateIncludesEntry(entry);
         if (!result.ok) return `'${entry}': ${result.reason}`;
       }
       return void 0;
     }
   });
-  return parseIncludesEntries(raw);
+  const paths = parseIncludesEntries(raw);
+  const entries = [];
+  for (const path5 of paths) {
+    const choice = await 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 each file"
+        }
+      ]
+    });
+    entries.push(buildIncludeEntry(path5, choice));
+  }
+  return entries;
+}
+function buildIncludeEntry(path5, choice) {
+  if (choice === "file-header") return path5;
+  const state = choice;
+  return { path: path5, state };
 }
 async function collectAuth(ctx) {
   const authType = await ctx.prompts.select({
@@ -1679,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());
@@ -1702,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");
     }
   }
@@ -1771,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: ""
@@ -1798,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;
 }