@starterculture/devkeep-actions 0.3.1 → 0.4.1

package/dist/consolidate-release.js

@@ -72,10 +72,14 @@ function createClaudeClient(apiKey) {
 // ../../modules/core/dist/claude/complete.js
 var DEFAULT_MAX_CONTINUATIONS = 5;
 var CONTINUATION_USER_MESSAGE = "Continue exactly where you left off. Do not repeat any text already written, and do not add any preamble or commentary \u2014 resume the previous response verbatim from the exact cutoff point.";
+var DEFAULT_REQUEST_TIMEOUT_MS = 24e4;
 async function createCompleteMessage(claude, params, { maxContinuations = DEFAULT_MAX_CONTINUATIONS, timeoutMs, signal } = {}) {
   let fullText = "";
   let usage = ZERO_USAGE;
-  const requestOptions = timeoutMs !== void 0 || signal !== void 0 ? { timeout: timeoutMs, signal } : void 0;
+  const requestOptions = {
+    timeout: timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+    ...signal !== void 0 ? { signal } : {}
+  };
   for (let attempt = 0; attempt <= maxContinuations; attempt++) {
     const messages = fullText ? [
       ...params.messages,
@@ -186,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: "" };
@@ -228,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");
 }
 
@@ -347,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,
@@ -358,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,
@@ -367,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),
@@ -395,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 };
@@ -412,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

@@ -72,10 +72,14 @@ function createClaudeClient(apiKey) {
 // ../../modules/core/dist/claude/complete.js
 var DEFAULT_MAX_CONTINUATIONS = 5;
 var CONTINUATION_USER_MESSAGE = "Continue exactly where you left off. Do not repeat any text already written, and do not add any preamble or commentary \u2014 resume the previous response verbatim from the exact cutoff point.";
+var DEFAULT_REQUEST_TIMEOUT_MS = 24e4;
 async function createCompleteMessage(claude, params, { maxContinuations = DEFAULT_MAX_CONTINUATIONS, timeoutMs, signal } = {}) {
   let fullText = "";
   let usage = ZERO_USAGE;
-  const requestOptions = timeoutMs !== void 0 || signal !== void 0 ? { timeout: timeoutMs, signal } : void 0;
+  const requestOptions = {
+    timeout: timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+    ...signal !== void 0 ? { signal } : {}
+  };
   for (let attempt = 0; attempt <= maxContinuations; attempt++) {
     const messages = fullText ? [
       ...params.messages,
@@ -233,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: "" };
@@ -363,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,
@@ -568,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, {
@@ -629,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
@@ -647,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/draft-release-notes.js

@@ -72,10 +72,14 @@ function createClaudeClient(apiKey) {
 // ../../modules/core/dist/claude/complete.js
 var DEFAULT_MAX_CONTINUATIONS = 5;
 var CONTINUATION_USER_MESSAGE = "Continue exactly where you left off. Do not repeat any text already written, and do not add any preamble or commentary \u2014 resume the previous response verbatim from the exact cutoff point.";
+var DEFAULT_REQUEST_TIMEOUT_MS = 24e4;
 async function createCompleteMessage(claude, params, { maxContinuations = DEFAULT_MAX_CONTINUATIONS, timeoutMs, signal } = {}) {
   let fullText = "";
   let usage = ZERO_USAGE;
-  const requestOptions = timeoutMs !== void 0 || signal !== void 0 ? { timeout: timeoutMs, signal } : void 0;
+  const requestOptions = {
+    timeout: timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+    ...signal !== void 0 ? { signal } : {}
+  };
   for (let attempt = 0; attempt <= maxContinuations; attempt++) {
     const messages = fullText ? [
       ...params.messages,

package/dist/sync-onboarding.js

@@ -72,10 +72,14 @@ function createClaudeClient(apiKey) {
 // ../../modules/core/dist/claude/complete.js
 var DEFAULT_MAX_CONTINUATIONS = 5;
 var CONTINUATION_USER_MESSAGE = "Continue exactly where you left off. Do not repeat any text already written, and do not add any preamble or commentary \u2014 resume the previous response verbatim from the exact cutoff point.";
+var DEFAULT_REQUEST_TIMEOUT_MS = 24e4;
 async function createCompleteMessage(claude, params, { maxContinuations = DEFAULT_MAX_CONTINUATIONS, timeoutMs, signal } = {}) {
   let fullText = "";
   let usage = ZERO_USAGE;
-  const requestOptions = timeoutMs !== void 0 || signal !== void 0 ? { timeout: timeoutMs, signal } : void 0;
+  const requestOptions = {
+    timeout: timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+    ...signal !== void 0 ? { signal } : {}
+  };
   for (let attempt = 0; attempt <= maxContinuations; attempt++) {
     const messages = fullText ? [
       ...params.messages,
@@ -164,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")}` : "",
     "",
@@ -268,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: "" };
@@ -360,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.3.1",
+  "version": "0.4.1",
   "description": "Devkeep's GitHub Actions entrypoints, bundled for CI runners.",
   "license": "UNLICENSED",
   "type": "module",