@starterculture/devkeep-actions 0.4.0 → 0.4.1

package/dist/consolidate-release.js

@@ -190,22 +190,22 @@ function isNotFound(error) {
   return typeof error === "object" && error !== null && "status" in error && error.status === 404;
 }
 
-// ../../modules/devlore/dist/masterDocs.js
-function masterDocsPath(projectName) {
-  return `projects/${projectName}/master/README.md`;
+// ../../modules/devlore/dist/canonicalDocs.js
+function canonicalDocsPath(projectName) {
+  return `projects/${projectName}/canonical/README.md`;
 }
-async function getMasterDocs(octokit, params) {
-  return (await getMasterDocsFile(octokit, params)).content;
+async function getCanonicalDocs(octokit, params) {
+  return (await getCanonicalDocsFile(octokit, params)).content;
 }
-async function getMasterDocsSha(octokit, params) {
-  return (await getMasterDocsFile(octokit, params)).sha;
+async function getCanonicalDocsSha(octokit, params) {
+  return (await getCanonicalDocsFile(octokit, params)).sha;
 }
-async function getMasterDocsFile(octokit, { owner, repo, projectName }) {
+async function getCanonicalDocsFile(octokit, { owner, repo, projectName }) {
   try {
     const { data } = await octokit.rest.repos.getContent({
       owner,
       repo,
-      path: masterDocsPath(projectName)
+      path: canonicalDocsPath(projectName)
     });
     if (Array.isArray(data) || data.type !== "file") {
       return { content: "" };
@@ -232,13 +232,13 @@ ${entry.content}`).join("\n\n");
     `Previous release: ${input.previousTag ?? "(none \u2014 this is the first release)"}`,
     `Date: ${input.date}`,
     "",
-    "Current master docs (may be empty if none exist yet):",
-    input.masterDocs || "(none yet)",
+    "Current canonical docs (may be empty if none exist yet):",
+    input.canonicalDocs || "(none yet)",
     "",
     "Log entries since the previous release:",
     entriesText || "(none)",
     "",
-    `Draft the updated master docs for ${input.projectName} as of ${input.tag}, folding in what changed across the log entries above into the current master docs. This is the official record, reviewed by a human before merging, so write it as durable reference documentation, not a changelog.`
+    `Draft the updated canonical docs for ${input.projectName} as of ${input.tag}, folding in what changed across the log entries above into the current canonical docs. This is the official record, reviewed by a human before merging, so write it as durable reference documentation, not a changelog.`
   ].join("\n");
 }
 
@@ -351,7 +351,7 @@ function releaseBranchName(projectName, tag) {
   return `devkeep/${projectName}/${tag}`;
 }
 async function consolidateRelease({ projectOctokit, vaultOctokit, claude, projectOwner, projectRepoName, vaultOwner, vaultRepoName, projectName, tag }) {
-  const [{ logEntries, previousTag }, masterDocs, masterDocsSha] = await Promise.all([
+  const [{ logEntries, previousTag }, canonicalDocs, canonicalDocsSha] = await Promise.all([
     selectLogEntriesSincePreviousRelease({
       vaultOctokit,
       projectOctokit,
@@ -362,8 +362,8 @@ async function consolidateRelease({ projectOctokit, vaultOctokit, claude, projec
       projectRepoName,
       tag
     }),
-    getMasterDocs(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName }),
-    getMasterDocsSha(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName })
+    getCanonicalDocs(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName }),
+    getCanonicalDocsSha(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName })
   ]);
   const prompt = buildConsolidationPrompt({
     projectName,
@@ -371,7 +371,7 @@ async function consolidateRelease({ projectOctokit, vaultOctokit, claude, projec
     previousTag,
     date: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
     logEntries,
-    masterDocs
+    canonicalDocs
   });
   const { text: draftedDocs, usage } = await createCompleteMessage(claude, {
     model: defaultModelFor(MODEL_TIER),
@@ -399,13 +399,13 @@ async function consolidateRelease({ projectOctokit, vaultOctokit, claude, projec
   await vaultOctokit.rest.repos.createOrUpdateFileContents({
     owner: vaultOwner,
     repo: vaultRepoName,
-    path: masterDocsPath(projectName),
+    path: canonicalDocsPath(projectName),
     message: `Consolidate release: ${projectName}@${tag}`,
     content: Buffer.from(draftedDocs, "utf-8").toString("base64"),
     branch,
-    sha: masterDocsSha
+    sha: canonicalDocsSha
   });
-  await recordUsage(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName, branch }, "consolidateRelease", usage);
+  await recordUsage(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName, branch: VAULT_BASE_BRANCH }, "consolidateRelease", usage);
   const openPrs = await vaultOctokit.rest.pulls.list({ owner: vaultOwner, repo: vaultRepoName, state: "open", head: `${vaultOwner}:${branch}` }).catch(() => ({ data: [] }));
   if (openPrs.data.length > 0) {
     return { branch, prNumber: openPrs.data[0].number, prUrl: openPrs.data[0].html_url, usage };
@@ -416,7 +416,7 @@ async function consolidateRelease({ projectOctokit, vaultOctokit, claude, projec
     title: `Consolidate release: ${projectName}@${tag}`,
     head: branch,
     base: VAULT_BASE_BRANCH,
-    body: `Drafted master doc update for \`${projectName}\` at \`${tag}\`, generated from the log entries since the last release. Review before merging \u2014 this updates the official docs.`
+    body: `Drafted canonical doc update for \`${projectName}\` at \`${tag}\`, generated from the log entries since the last release. Review before merging \u2014 this updates the official docs.`
   });
   return { branch, prNumber: pr.data.number, prUrl: pr.data.html_url, usage };
 }

package/dist/draft-log-entry.js

@@ -237,19 +237,19 @@ async function getProjectDiff(octokit, { owner, repo, base, head }) {
   }
 }
 
-// ../../modules/devlore/dist/masterDocs.js
-function masterDocsPath(projectName) {
-  return `projects/${projectName}/master/README.md`;
+// ../../modules/devlore/dist/canonicalDocs.js
+function canonicalDocsPath(projectName) {
+  return `projects/${projectName}/canonical/README.md`;
 }
-async function getMasterDocs(octokit, params) {
-  return (await getMasterDocsFile(octokit, params)).content;
+async function getCanonicalDocs(octokit, params) {
+  return (await getCanonicalDocsFile(octokit, params)).content;
 }
-async function getMasterDocsFile(octokit, { owner, repo, projectName }) {
+async function getCanonicalDocsFile(octokit, { owner, repo, projectName }) {
   try {
     const { data } = await octokit.rest.repos.getContent({
       owner,
       repo,
-      path: masterDocsPath(projectName)
+      path: canonicalDocsPath(projectName)
     });
     if (Array.isArray(data) || data.type !== "file") {
       return { content: "" };
@@ -367,8 +367,8 @@ ${file.patch}`).join("\n\n");
     "Commit messages:",
     input.commitMessages.map((message) => `- ${message}`).join("\n"),
     "",
-    "Current master docs (may be empty if none exist yet):",
-    input.masterDocs || "(none yet)",
+    "Current canonical docs (may be empty if none exist yet):",
+    input.canonicalDocs || "(none yet)",
     "",
     "Diff:",
     diff,
@@ -572,13 +572,13 @@ async function syncProductDoc(projectOctokit, vaultOctokit, { projectOwner, proj
     });
   });
 }
-async function draftBucketLogEntry({ vaultOctokit, claude, vaultOwner, vaultRepoName, projectName, headSha, date, commitMessages, files, masterDocs, moduleId, moduleName }) {
+async function draftBucketLogEntry({ vaultOctokit, claude, vaultOwner, vaultRepoName, projectName, headSha, date, commitMessages, files, canonicalDocs, moduleId, moduleName }) {
   const prompt = buildLogEntryPrompt({
     projectName,
     date,
     commitMessages,
     files,
-    masterDocs,
+    canonicalDocs,
     moduleName: moduleName ?? void 0
   });
   const { text, usage } = await createCompleteMessage(claude, {
@@ -633,7 +633,7 @@ async function draftLogEntry({ projectOctokit, vaultOctokit, claude, projectOwne
     ref: headSha
   });
   const buckets = routeDiffByModule(diff.files, manifest);
-  const masterDocs = await getMasterDocs(vaultOctokit, {
+  const canonicalDocs = await getCanonicalDocs(vaultOctokit, {
     owner: vaultOwner,
     repo: vaultRepoName,
     projectName
@@ -651,7 +651,7 @@ async function draftLogEntry({ projectOctokit, vaultOctokit, claude, projectOwne
       date,
       commitMessages: diff.commitMessages,
       files: bucket.files,
-      masterDocs,
+      canonicalDocs,
       moduleId: bucket.moduleId,
       moduleName: bucket.moduleName
     });

package/dist/sync-onboarding.js

@@ -168,8 +168,8 @@ function buildOnboardingGuidePrompt(input) {
     "",
     input.currentState ? `--- Current state ---
 ${input.currentState}` : "",
-    input.masterDocs ? `--- Master docs ---
-${input.masterDocs}` : "",
+    input.canonicalDocs ? `--- Canonical docs ---
+${input.canonicalDocs}` : "",
     input.decisions.length > 0 ? `--- Decisions ---
 ${input.decisions.join("\n\n")}` : "",
     "",
@@ -272,19 +272,19 @@ function isNotFound2(error) {
   return typeof error === "object" && error !== null && "status" in error && error.status === 404;
 }
 
-// ../../modules/devlore/dist/masterDocs.js
-function masterDocsPath(projectName) {
-  return `projects/${projectName}/master/README.md`;
+// ../../modules/devlore/dist/canonicalDocs.js
+function canonicalDocsPath(projectName) {
+  return `projects/${projectName}/canonical/README.md`;
 }
-async function getMasterDocs(octokit, params) {
-  return (await getMasterDocsFile(octokit, params)).content;
+async function getCanonicalDocs(octokit, params) {
+  return (await getCanonicalDocsFile(octokit, params)).content;
 }
-async function getMasterDocsFile(octokit, { owner, repo, projectName }) {
+async function getCanonicalDocsFile(octokit, { owner, repo, projectName }) {
   try {
     const { data } = await octokit.rest.repos.getContent({
       owner,
       repo,
-      path: masterDocsPath(projectName)
+      path: canonicalDocsPath(projectName)
     });
     if (Array.isArray(data) || data.type !== "file") {
       return { content: "" };
@@ -364,15 +364,15 @@ async function readVaultFile(octokit, owner, repo, path) {
   return data && !Array.isArray(data) && data.type === "file" ? Buffer.from(data.content, "base64").toString("utf-8") : "";
 }
 async function syncOnboarding({ projectOctokit, vaultOctokit, claude, projectOwner, projectRepoName, vaultOwner, vaultRepoName, projectName }) {
-  const [currentState, masterDocs, entries] = await Promise.all([
+  const [currentState, canonicalDocs, entries] = await Promise.all([
     readVaultFile(vaultOctokit, vaultOwner, vaultRepoName, currentStatePath(projectName)),
-    getMasterDocs(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName }).catch(() => ""),
+    getCanonicalDocs(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName }).catch(() => ""),
     listDecisionEntries(vaultOctokit, { owner: vaultOwner, repo: vaultRepoName, projectName }).catch(() => [])
   ]);
   const prompt = buildOnboardingGuidePrompt({
     projectName,
     currentState: redactText(currentState),
-    masterDocs: redactText(masterDocs),
+    canonicalDocs: redactText(canonicalDocs),
     decisions: entries.map((entry) => redactText(entry.content))
   });
   const { text, usage } = await createCompleteMessage(claude, { model: defaultModelFor(MODEL_TIER), max_tokens: MAX_TOKENS, messages: [{ role: "user", content: prompt }] }, { maxContinuations: MAX_CONTINUATIONS });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starterculture/devkeep-actions",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Devkeep's GitHub Actions entrypoints, bundled for CI runners.",
   "license": "UNLICENSED",
   "type": "module",