@enhansome/core 1.10.0 → 1.10.1

package/dist/github.d.ts

@@ -77,11 +77,12 @@ export interface MakeOctokitOptions {
 export declare function makeOctokit(token: string, { log, maxRetries, maxWaitSeconds, throttle, }?: MakeOctokitOptions): GithubClient;
 export declare function getRepoInfo(octokit: GithubClient, owner: string, repo: string): Promise<RepoInfoDetails>;
 /**
- * The repo's numeric GitHub id, for the JSON metadata — consumers key stable
- * node ids on it. Returns null (logged) instead of failing the run: the id is
- * metadata, not a gate; consumers fall back when it is missing.
+ * The repo's full info, for the JSON metadata — the numeric id consumers key
+ * stable node ids on, plus the stars/language/last_commit the root's own
+ * metadata row is built from. Returns null (logged) instead of failing the
+ * run: metadata is not a gate; consumers fall back when it is missing.
  */
-export declare function getRepoId(octokit: GithubClient, owner: string, repo: string): Promise<null | number>;
+export declare function getRepoInfoOrNull(octokit: GithubClient, owner: string, repo: string): Promise<null | RepoInfoDetails>;
 export declare function getReadme(octokit: GithubClient, owner: string, repo: string, format?: 'html' | 'raw'): Promise<string>;
 /** Root file/directory names — the compile-manifest gate reads them to tell a
  * directory of resources from a repo that IS the deliverable. A `path: ''`

package/dist/github.js

@@ -83,16 +83,17 @@ export async function getRepoInfo(octokit, owner, repo) {
     };
 }
 /**
- * The repo's numeric GitHub id, for the JSON metadata — consumers key stable
- * node ids on it. Returns null (logged) instead of failing the run: the id is
- * metadata, not a gate; consumers fall back when it is missing.
+ * The repo's full info, for the JSON metadata — the numeric id consumers key
+ * stable node ids on, plus the stars/language/last_commit the root's own
+ * metadata row is built from. Returns null (logged) instead of failing the
+ * run: metadata is not a gate; consumers fall back when it is missing.
  */
-export async function getRepoId(octokit, owner, repo) {
+export async function getRepoInfoOrNull(octokit, owner, repo) {
     try {
-        return (await getRepoInfo(octokit, owner, repo)).id;
+        return await getRepoInfo(octokit, owner, repo);
     }
     catch (error) {
-        octokit.log.error(`Failed to fetch repo id for ${owner}/${repo}: ${formatRequestError(error)}`);
+        octokit.log.error(`Failed to fetch repo info for ${owner}/${repo}: ${formatRequestError(error)}`);
         return null;
     }
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { formatRequestError, getLatestCommitSha, getReadme, getRepoId, getRepoInfo, getRootEntryNames, makeOctokit, parseGitHubUrl, parseOwnerRepo, } from './github.js';
+export { formatRequestError, getLatestCommitSha, getReadme, getRepoInfo, getRepoInfoOrNull, getRootEntryNames, makeOctokit, parseGitHubUrl, parseOwnerRepo, } from './github.js';
 export type { GithubClient, MakeOctokitOptions, RepoIdentifier, RepoInfoDetails, ThrottleOptions, } from './github.js';
 export type { Logger } from './logger.js';
 export { consoleLog, silentLog } from './logger.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { formatRequestError, getLatestCommitSha, getReadme, getRepoId, getRepoInfo, getRootEntryNames, makeOctokit, parseGitHubUrl, parseOwnerRepo, } from './github.js';
+export { formatRequestError, getLatestCommitSha, getReadme, getRepoInfo, getRepoInfoOrNull, getRootEntryNames, makeOctokit, parseGitHubUrl, parseOwnerRepo, } from './github.js';
 export { consoleLog, silentLog } from './logger.js';
 export { toRepoInfo } from './markdown.js';
 export { enhance } from './orchestrator.js';

package/dist/markdown.d.ts

@@ -45,8 +45,7 @@ export interface JsonMetadata {
     enhanced_repository: null | string;
     enhanced_repository_description: null | string;
     last_updated: string;
-    original_repository: string;
-    original_repository_id: null | number;
+    original_repository_info: null | RepoInfo;
     original_repository_sha: null | string;
     title: string;
 }
@@ -55,7 +54,7 @@ export interface JsonSection {
     items: JsonNode[];
     title: string;
 }
-export declare function processMarkdownContent(originalContent: string, token: string, replacements: ReplacementRule[] | undefined, sortOptions: SortOptions | undefined, originalRepository: string, relativeLinkPrefix?: string, enhancedRepository?: string, enhancedRepositoryDescription?: string, originalRepositorySha?: string, originalRepositoryId?: number, now?: Date, log?: Logger): Promise<{
+export declare function processMarkdownContent(originalContent: string, token: string, replacements?: ReplacementRule[], sortOptions?: SortOptions, relativeLinkPrefix?: string, enhancedRepository?: string, enhancedRepositoryDescription?: string, originalRepositorySha?: string, originalRepositoryInfo?: null | RepoInfoDetails, now?: Date, log?: Logger): Promise<{
     finalContent: string;
     jsonData: JsonOutput;
 }>;

package/dist/markdown.js

@@ -79,7 +79,7 @@ async function fetchTargetData(urls, repos) {
     log.info(`Target fetch: ${repoInfoMap.size}/${urls.size} repo-info ok in ${Date.now() - fetchStart}ms (concurrency ${FETCH_CONCURRENCY}).`);
     return repoInfoMap;
 }
-export async function processMarkdownContent(originalContent, token, replacements = [], sortOptions = { by: '', minLinks: 2 }, originalRepository, relativeLinkPrefix = '', enhancedRepository, enhancedRepositoryDescription, originalRepositorySha, originalRepositoryId, now = new Date(), log = consoleLog) {
+export async function processMarkdownContent(originalContent, token, replacements = [], sortOptions = { by: '', minLinks: 2 }, relativeLinkPrefix = '', enhancedRepository, enhancedRepositoryDescription, originalRepositorySha, originalRepositoryInfo, now = new Date(), log = consoleLog) {
     const repos = createRepoInfoLookup(token, log);
     const brandingEnabled = replacements.some(rule => rule.type === 'branding');
     const contentAfterReplacements = applyTextReplacements(originalContent, replacements.filter(rule => rule.type !== 'branding'), log);
@@ -88,9 +88,7 @@ export async function processMarkdownContent(originalContent, token, replacement
     normalizeGitHubUrls(tree);
     const githubUrls = collectGitHubLinks(tree);
     const repoInfoMap = await fetchTargetData(githubUrls, repos);
-    // The title derives from the *source* repository (originalRepository), never
-    // the enhanced/mirror repo — otherwise the org name doubles into the title.
-    const { sections, title: rawTitle, titleHeadingIndex, } = processTree(tree, repoInfoMap, sortOptions, originalRepository);
+    const { sections, title: rawTitle, titleHeadingIndex, } = processTree(tree, repoInfoMap, sortOptions, originalRepositoryInfo);
     // Single source of truth for the document title: brand it once and use the
     // same value for the markdown H1 and metadata.title (parity).
     const title = brandingEnabled ? brandTitle(rawTitle) : rawTitle;
@@ -99,8 +97,9 @@ export async function processMarkdownContent(originalContent, token, replacement
     }
     const metadata = {
         last_updated: now.toISOString(),
-        original_repository: originalRepository.trim(),
-        original_repository_id: originalRepositoryId ?? null,
+        original_repository_info: originalRepositoryInfo
+            ? toRepoInfo(originalRepositoryInfo)
+            : null,
         original_repository_sha: (originalRepositorySha?.trim() ?? '') || null,
         enhanced_repository: (enhancedRepository?.trim() ?? '') || null,
         enhanced_repository_description: (enhancedRepositoryDescription?.trim() ?? '') || null,
@@ -812,22 +811,6 @@ const INVALID_TITLE_PATTERNS = [
     /^video$/i,
     /^science/i,
 ];
-function repoNameFromIdentifier(identifier) {
-    const trimmed = identifier.trim();
-    if (!trimmed) {
-        return '';
-    }
-    if (/^https?:\/\//i.test(trimmed)) {
-        const parts = trimmed
-            .replace(/\.git$/i, '')
-            .replace(/[?#].*$/, '')
-            .split('/')
-            .filter(Boolean);
-        return parts[parts.length - 1] ?? '';
-    }
-    const slashIndex = trimmed.lastIndexOf('/');
-    return slashIndex === -1 ? trimmed : trimmed.slice(slashIndex + 1);
-}
 function formatRepoNameAsTitle(repoName) {
     const cleaned = repoName.replace(/[-_]/g, ' ').replace(/\s+/g, ' ').trim();
     if (/^awesome\s+/i.test(cleaned)) {
@@ -911,7 +894,7 @@ function applyBrandingToTree(tree, title, titleHeadingIndex) {
         tree.children.unshift(heading);
     }
 }
-function processTree(tree, repoInfoMap, sortOptions, originalRepository) {
+function processTree(tree, repoInfoMap, sortOptions, originalRepositoryInfo) {
     // Remember the title H1's index so branding replaces the exact same node;
     // scope matches branding/section-building so they can't drift apart.
     const titleHeadingIndex = findTitleHeadingIndex(tree);
@@ -922,11 +905,8 @@ function processTree(tree, repoInfoMap, sortOptions, originalRepository) {
     // Derive a subject from the *source* repository name when no valid H1 is
     // present. Using the source — not the enhanced/mirror repo — keeps the org
     // name out of the title.
-    if (documentTitle === '' && originalRepository) {
-        const repoName = repoNameFromIdentifier(originalRepository);
-        if (repoName) {
-            documentTitle = formatRepoNameAsTitle(repoName);
-        }
+    if (documentTitle === '' && originalRepositoryInfo) {
+        documentTitle = formatRepoNameAsTitle(originalRepositoryInfo.repo);
     }
     const sectionDepth = findSectionDepth(tree, titleSlotIndex);
     const gateForSection = sectionGatePasses(tree, titleSlotIndex, sectionDepth, repoInfoMap, sortOptions);

package/dist/orchestrator.d.ts

@@ -1,4 +1,5 @@
 import { Logger } from './logger.js';
+import type { RepoInfoDetails } from './github.js';
 import { JsonOutput, ReplacementRule } from './markdown.js';
 export interface EnhanceOptions {
     content: string;
@@ -8,11 +9,9 @@ export interface EnhanceOptions {
     /** Defaults to the console sink; pass your own (e.g. an Actions workflow-command sink) to route diagnostics. */
     log?: Logger;
     now?: Date;
-    originalRepository: string;
-    originalRepositoryId?: number;
+    originalRepositoryInfo?: null | RepoInfoDetails;
     originalRepositorySha?: string;
     relativeLinkPrefix?: string;
-    /** Text substitutions applied to the source before it is parsed. */
     replacements?: ReplacementRule[];
     sortBy?: '' | 'last_commit' | 'stars';
     token: string;

package/dist/orchestrator.js

@@ -1,6 +1,6 @@
 import { processMarkdownContent, } from './markdown.js';
 export async function enhance(options) {
-    const { content, disableBranding = false, log, now = new Date(), originalRepository, originalRepositoryId, originalRepositorySha, relativeLinkPrefix = '', replacements = [], sortBy = '', enhancedRepository, enhancedRepositoryDescription, token, } = options;
+    const { content, disableBranding = false, log, now = new Date(), originalRepositoryInfo, originalRepositorySha, relativeLinkPrefix = '', replacements = [], sortBy = '', enhancedRepository, enhancedRepositoryDescription, token, } = options;
     // Branding is an internal rule prepended to the caller's own; build a fresh
     // array so the caller's `replacements` is never mutated.
     const branding = { type: 'branding' };
@@ -9,7 +9,7 @@ export async function enhance(options) {
         by: sortBy,
         minLinks: 2,
     };
-    const { finalContent, jsonData } = await processMarkdownContent(content, token, rules, sortOptions, originalRepository, relativeLinkPrefix, enhancedRepository, enhancedRepositoryDescription, originalRepositorySha, originalRepositoryId, now, log);
+    const { finalContent, jsonData } = await processMarkdownContent(content, token, rules, sortOptions, relativeLinkPrefix, enhancedRepository, enhancedRepositoryDescription, originalRepositorySha, originalRepositoryInfo, now, log);
     return {
         finalContent,
         jsonData,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enhansome/core",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Library core for enhansome — enhance markdown with GitHub star counts.",
   "repository": {
     "type": "git",