@link-assistant/web-capture 1.1.2 → 1.7.1

package/scripts/format-release-notes.mjs

@@ -1,218 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Script to format GitHub release notes with proper formatting:
- * - Fix special characters like \n
- * - Add link to PR that contains the release commit (if found)
- * - Add shields.io NPM version badge
- * - Format nicely with proper markdown
- *
- * IMPORTANT: Update the PACKAGE_NAME constant below to match your package.json
- *
- * PR Detection Logic:
- * 1. Extract commit hash from changelog entry (if present)
- * 2. Fall back to --commit-sha argument (passed from workflow)
- * 3. Look up PRs that contain the commit via GitHub API
- * 4. If no PR found, simply don't display any PR link (no guessing)
- *
- * Uses link-foundation libraries:
- * - use-m: Dynamic package loading without package.json dependencies
- * - command-stream: Modern shell command execution with streaming support
- * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
- *
- * Note: Uses --release-version instead of --version to avoid conflict with yargs' built-in --version flag.
- */
-
-const PACKAGE_NAME = '@link-assistant/web-capture';
-
-// Load use-m dynamically
-const { use } = eval(
-  await (await fetch('https://unpkg.com/use-m/use.js')).text()
-);
-
-// Import link-foundation libraries
-const { $ } = await use('command-stream');
-const { makeConfig } = await use('lino-arguments');
-
-// Parse CLI arguments using lino-arguments
-// Note: Using --release-version instead of --version to avoid conflict with yargs' built-in --version flag
-const config = makeConfig({
-  yargs: ({ yargs, getenv }) =>
-    yargs
-      .option('release-version', {
-        type: 'string',
-        default: getenv('VERSION', ''),
-        describe: 'Version number (e.g., v0.8.36)',
-      })
-      .option('release-id', {
-        type: 'string',
-        default: getenv('RELEASE_ID', ''),
-        describe: 'GitHub release ID',
-      })
-      .option('repository', {
-        type: 'string',
-        default: getenv('REPOSITORY', ''),
-        describe: 'GitHub repository (e.g., owner/repo)',
-      })
-      .option('commit-sha', {
-        type: 'string',
-        default: getenv('COMMIT_SHA', ''),
-        describe: 'Commit SHA for PR detection',
-      }),
-});
-
-const releaseId = config.releaseId;
-const version = config.releaseVersion;
-const repository = config.repository;
-const passedCommitSha = config.commitSha;
-
-if (!releaseId || !version || !repository) {
-  console.error(
-    'Usage: format-release-notes.mjs --release-id <releaseId> --release-version <version> --repository <repository> [--commit-sha <sha>]'
-  );
-  process.exit(1);
-}
-
-try {
-  // Get current release body
-  const result = await $`gh api repos/${repository}/releases/${releaseId}`.run({
-    capture: true,
-  });
-  const releaseData = JSON.parse(result.stdout);
-
-  const currentBody = releaseData.body || '';
-
-  // Skip if already formatted (has shields.io badge image)
-  if (currentBody.includes('img.shields.io')) {
-    console.log('ℹ️ Release notes already formatted');
-    process.exit(0);
-  }
-
-  // Extract changes section (Major, Minor, or Patch)
-  // This regex handles multiple formats:
-  // 1. With commit hash: "### [Major|Minor|Patch] Changes\n- abc1234: Description"
-  // 2. Without commit hash: "### [Major|Minor|Patch] Changes\n- Description"
-  const changesPattern =
-    /### (Major|Minor|Patch) Changes\s*\n\s*-\s+(?:([a-f0-9]+):\s+)?(.+?)$/s;
-  const changesMatch = currentBody.match(changesPattern);
-
-  let commitHash = null;
-  let rawDescription = null;
-  let changeType = null;
-
-  if (changesMatch) {
-    // Extract: [full match, changeType, commitHash (optional), description]
-    [, changeType, commitHash, rawDescription] = changesMatch;
-    console.log(`ℹ️ Found ${changeType} Changes section`);
-
-    // If commitHash is undefined and description contains it, try to extract
-    if (!commitHash && rawDescription) {
-      // This handles the case where description itself might be null/undefined
-      // and we need to safely check for commit hash at the start
-      const descWithHashMatch = rawDescription.match(/^([a-f0-9]+):\s+(.+)$/s);
-      if (descWithHashMatch) {
-        [, commitHash, rawDescription] = descWithHashMatch;
-      }
-    }
-  } else {
-    console.log('⚠️ Could not parse changes from release notes');
-    console.log('   Looking for pattern: ### [Major|Minor|Patch] Changes');
-    process.exit(0);
-  }
-
-  // Clean up the description:
-  // 1. Convert literal \n sequences (escaped newlines from GitHub API) to actual newlines
-  // 2. Remove leading/trailing quotes (including escaped quotes from command-stream shell escaping)
-  // 3. Remove any trailing npm package links or markdown that might be there
-  // 4. Normalize whitespace while preserving line breaks
-  const cleanDescription = rawDescription
-    .replace(/\\n/g, '\n') // Convert escaped \n to actual newlines
-    .replace(/^(\\['"])+/g, '') // Remove leading escaped quotes (e.g., \', \", \'', \'')
-    .replace(/(['"])+$/g, '') // Remove trailing unescaped quotes (e.g., ', ", '', '')
-    .replace(/^(['"])+/g, '') // Remove leading unescaped quotes
-    .replace(/📦.*$/s, '') // Remove any existing npm package info
-    .replace(/---.*$/s, '') // Remove any existing separators and everything after
-    .trim()
-    .split('\n') // Split by lines
-    .map((line) => line.trim()) // Trim whitespace from each line
-    .join('\n') // Rejoin with newlines
-    .replace(/\n{3,}/g, '\n\n'); // Normalize excessive blank lines (3+ becomes 2)
-
-  // Find the PR that contains the release commit
-  // Uses commit hash from changelog or passed commit SHA from workflow
-  let prNumber = null;
-
-  // Determine which commit SHA to use for PR lookup
-  const commitShaToLookup = commitHash || passedCommitSha;
-
-  if (commitShaToLookup) {
-    const source = commitHash ? 'changelog' : 'workflow';
-    console.log(
-      `ℹ️ Looking up PR for commit ${commitShaToLookup} (from ${source})`
-    );
-
-    try {
-      const prResult =
-        await $`gh api "repos/${repository}/commits/${commitShaToLookup}/pulls"`.run(
-          { capture: true }
-        );
-      const prsData = JSON.parse(prResult.stdout);
-
-      // Find the PR that's not the version bump PR (not "chore: version packages")
-      const relevantPr = prsData.find(
-        (pr) => !pr.title.includes('version packages')
-      );
-
-      if (relevantPr) {
-        prNumber = relevantPr.number;
-        console.log(`✅ Found PR #${prNumber} containing commit`);
-      } else if (prsData.length > 0) {
-        console.log(
-          '⚠️ Found PRs but all are version bump PRs, not linking any'
-        );
-      } else {
-        console.log(
-          'ℹ️ No PR found containing this commit - not adding PR link'
-        );
-      }
-    } catch (error) {
-      console.log('⚠️ Could not find PR for commit', commitShaToLookup);
-      console.log('   Error:', error.message);
-      if (process.env.DEBUG) {
-        console.error(error);
-      }
-    }
-  } else {
-    // No commit hash available from any source
-    console.log('ℹ️ No commit SHA available - not adding PR link');
-  }
-
-  // Build formatted release notes
-  const versionWithoutV = version.replace(/^v/, '');
-  const npmBadge = `[![npm version](https://img.shields.io/badge/npm-${versionWithoutV}-blue.svg)](https://www.npmjs.com/package/${PACKAGE_NAME}/v/${versionWithoutV})`;
-
-  let formattedBody = `${cleanDescription}`;
-
-  // Add PR link if available
-  if (prNumber) {
-    formattedBody += `\n\n**Related Pull Request:** #${prNumber}`;
-  }
-
-  formattedBody += `\n\n---\n\n${npmBadge}`;
-
-  // Update the release using JSON input to properly handle special characters
-  const updatePayload = JSON.stringify({ body: formattedBody });
-  await $`gh api repos/${repository}/releases/${releaseId} -X PATCH --input -`.run(
-    { stdin: updatePayload }
-  );
-
-  console.log(`✅ Formatted release notes for v${versionWithoutV}`);
-  if (prNumber) {
-    console.log(`   - Added link to PR #${prNumber}`);
-  }
-  console.log('   - Added shields.io npm badge');
-  console.log('   - Cleaned up formatting');
-} catch (error) {
-  console.error('❌ Error formatting release notes:', error.message);
-  process.exit(1);
-}

package/scripts/instant-version-bump.mjs

@@ -1,121 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Instant version bump script for manual releases
- * Bypasses the changeset workflow and directly updates version and changelog
- *
- * Usage: node scripts/instant-version-bump.mjs --bump-type <major|minor|patch> [--description <description>]
- *
- * Uses link-foundation libraries:
- * - use-m: Dynamic package loading without package.json dependencies
- * - command-stream: Modern shell command execution with streaming support
- * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
- */
-
-import { readFileSync, writeFileSync } from 'fs';
-
-// Load use-m dynamically
-const { use } = eval(
-  await (await fetch('https://unpkg.com/use-m/use.js')).text()
-);
-
-// Import link-foundation libraries
-const { $ } = await use('command-stream');
-const { makeConfig } = await use('lino-arguments');
-
-// Parse CLI arguments using lino-arguments
-const config = makeConfig({
-  yargs: ({ yargs, getenv }) =>
-    yargs
-      .option('bump-type', {
-        type: 'string',
-        default: getenv('BUMP_TYPE', ''),
-        describe: 'Version bump type: major, minor, or patch',
-        choices: ['major', 'minor', 'patch'],
-      })
-      .option('description', {
-        type: 'string',
-        default: getenv('DESCRIPTION', ''),
-        describe: 'Description for the version bump',
-      }),
-});
-
-try {
-  const { bumpType, description } = config;
-  const finalDescription = description || `Manual ${bumpType} release`;
-
-  if (!bumpType || !['major', 'minor', 'patch'].includes(bumpType)) {
-    console.error(
-      'Usage: node scripts/instant-version-bump.mjs --bump-type <major|minor|patch> [--description <description>]'
-    );
-    process.exit(1);
-  }
-
-  console.log(`\nBumping version (${bumpType})...`);
-
-  // Get current version
-  const packageJson = JSON.parse(readFileSync('package.json', 'utf-8'));
-  const oldVersion = packageJson.version;
-  console.log(`Current version: ${oldVersion}`);
-
-  // Bump version using npm version (doesn't create git tag)
-  await $`npm version ${bumpType} --no-git-tag-version`;
-
-  // Get new version
-  const updatedPackageJson = JSON.parse(readFileSync('package.json', 'utf-8'));
-  const newVersion = updatedPackageJson.version;
-  console.log(`New version: ${newVersion}`);
-
-  // Update CHANGELOG.md
-  console.log('\nUpdating CHANGELOG.md...');
-  const changelogPath = 'CHANGELOG.md';
-  let changelog = readFileSync(changelogPath, 'utf-8');
-
-  // Create new changelog entry
-  const newEntry = `## ${newVersion}
-
-### ${bumpType.charAt(0).toUpperCase() + bumpType.slice(1)} Changes
-
-- ${finalDescription}
-
-`;
-
-  // Insert new entry after the first heading (# Changelog or similar)
-  // Look for the first ## heading and insert before it
-  const firstVersionMatch = changelog.match(/^## /m);
-
-  if (firstVersionMatch) {
-    const insertPosition = firstVersionMatch.index;
-    changelog =
-      changelog.slice(0, insertPosition) +
-      newEntry +
-      changelog.slice(insertPosition);
-  } else {
-    // If no version headings exist, append after the main heading
-    const mainHeadingMatch = changelog.match(/^# .+$/m);
-    if (mainHeadingMatch) {
-      const insertPosition =
-        mainHeadingMatch.index + mainHeadingMatch[0].length;
-      changelog = `${changelog.slice(0, insertPosition)}\n\n${newEntry}${changelog.slice(insertPosition)}`;
-    } else {
-      // If no headings at all, prepend
-      changelog = `${newEntry}\n${changelog}`;
-    }
-  }
-
-  writeFileSync(changelogPath, changelog, 'utf-8');
-  console.log('✅ CHANGELOG.md updated');
-
-  // Synchronize package-lock.json
-  console.log('\nSynchronizing package-lock.json...');
-  await $`npm install --package-lock-only`;
-
-  console.log('\n✅ Instant version bump complete');
-  console.log(`Version: ${oldVersion} → ${newVersion}`);
-} catch (error) {
-  console.error('Error during instant version bump:', error.message);
-  if (process.env.DEBUG) {
-    console.error('Stack trace:', error.stack);
-  }
-  process.exit(1);
-}

package/scripts/publish-to-npm.mjs

@@ -1,128 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Publish to npm using OIDC trusted publishing
- * Usage: node scripts/publish-to-npm.mjs [--should-pull]
- *   should_pull: Optional flag to pull latest changes before publishing (for release job)
- *
- * IMPORTANT: Update the PACKAGE_NAME constant below to match your package.json
- *
- * Uses link-foundation libraries:
- * - use-m: Dynamic package loading without package.json dependencies
- * - command-stream: Modern shell command execution with streaming support
- * - lino-arguments: Unified configuration from CLI args, env vars, and .lenv files
- */
-
-import { readFileSync, appendFileSync } from 'fs';
-
-const PACKAGE_NAME = '@link-assistant/web-capture';
-
-// Load use-m dynamically
-const { use } = eval(
-  await (await fetch('https://unpkg.com/use-m/use.js')).text()
-);
-
-// Import link-foundation libraries
-const { $ } = await use('command-stream');
-const { makeConfig } = await use('lino-arguments');
-
-// Parse CLI arguments using lino-arguments
-const config = makeConfig({
-  yargs: ({ yargs, getenv }) =>
-    yargs.option('should-pull', {
-      type: 'boolean',
-      default: getenv('SHOULD_PULL', false),
-      describe: 'Pull latest changes before publishing',
-    }),
-});
-
-const { shouldPull } = config;
-const MAX_RETRIES = 3;
-const RETRY_DELAY = 10000; // 10 seconds
-
-/**
- * Sleep for specified milliseconds
- * @param {number} ms
- */
-function sleep(ms) {
-  return new Promise((resolve) => globalThis.setTimeout(resolve, ms));
-}
-
-/**
- * Append to GitHub Actions output file
- * @param {string} key
- * @param {string} value
- */
-function setOutput(key, value) {
-  const outputFile = process.env.GITHUB_OUTPUT;
-  if (outputFile) {
-    appendFileSync(outputFile, `${key}=${value}\n`);
-  }
-}
-
-async function main() {
-  try {
-    if (shouldPull) {
-      // Pull the latest changes we just pushed
-      await $`git pull origin main`;
-    }
-
-    // Get current version
-    const packageJson = JSON.parse(readFileSync('./package.json', 'utf8'));
-    const currentVersion = packageJson.version;
-    console.log(`Current version to publish: ${currentVersion}`);
-
-    // Check if this version is already published on npm
-    console.log(
-      `Checking if version ${currentVersion} is already published...`
-    );
-    const checkResult =
-      await $`npm view "${PACKAGE_NAME}@${currentVersion}" version`.run({
-        capture: true,
-      });
-
-    // command-stream returns { code: 0 } on success, { code: 1 } on failure (e.g., E404)
-    // Exit code 0 means version exists, non-zero means version not found
-    if (checkResult.code === 0) {
-      console.log(`Version ${currentVersion} is already published to npm`);
-      setOutput('published', 'true');
-      setOutput('published_version', currentVersion);
-      setOutput('already_published', 'true');
-      return;
-    } else {
-      // Version not found on npm (E404), proceed with publish
-      console.log(
-        `Version ${currentVersion} not found on npm, proceeding with publish...`
-      );
-    }
-
-    // Publish to npm using OIDC trusted publishing with retry logic
-    for (let i = 1; i <= MAX_RETRIES; i++) {
-      console.log(`Publish attempt ${i} of ${MAX_RETRIES}...`);
-      try {
-        await $`npm run changeset:publish`;
-        setOutput('published', 'true');
-        setOutput('published_version', currentVersion);
-        console.log(
-          `\u2705 Published ${PACKAGE_NAME}@${currentVersion} to npm`
-        );
-        return;
-      } catch (error) {
-        if (i < MAX_RETRIES) {
-          console.log(
-            `Publish failed: ${error.message}, waiting ${RETRY_DELAY / 1000}s before retry...`
-          );
-          await sleep(RETRY_DELAY);
-        }
-      }
-    }
-
-    console.error(`\u274C Failed to publish after ${MAX_RETRIES} attempts`);
-    process.exit(1);
-  } catch (error) {
-    console.error('Error:', error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/scripts/setup-npm.mjs

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Update npm for OIDC trusted publishing
- * npm trusted publishing requires npm >= 11.5.1
- * Node.js 20.x ships with npm 10.x, so we need to update
- *
- * Uses link-foundation libraries:
- * - use-m: Dynamic package loading without package.json dependencies
- * - command-stream: Modern shell command execution with streaming support
- */
-
-// Load use-m dynamically
-const { use } = eval(
-  await (await fetch('https://unpkg.com/use-m/use.js')).text()
-);
-
-// Import command-stream for shell command execution
-const { $ } = await use('command-stream');
-
-try {
-  // Get current npm version
-  const currentResult = await $`npm --version`.run({ capture: true });
-  const currentVersion = currentResult.stdout.trim();
-  console.log(`Current npm version: ${currentVersion}`);
-
-  // Update npm to latest
-  await $`npm install -g npm@latest`;
-
-  // Get updated npm version
-  const updatedResult = await $`npm --version`.run({ capture: true });
-  const updatedVersion = updatedResult.stdout.trim();
-  console.log(`Updated npm version: ${updatedVersion}`);
-} catch (error) {
-  console.error('Error updating npm:', error.message);
-  process.exit(1);
-}

package/scripts/validate-changeset.mjs

@@ -1,106 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Validate changeset for CI - ensures exactly one valid changeset exists
- *
- * IMPORTANT: Update the package name below to match your package.json
- */
-
-import { readdirSync, readFileSync } from 'fs';
-import { join } from 'path';
-
-const PACKAGE_NAME = '@link-assistant/web-capture';
-
-try {
-  // Count changeset files (excluding README.md and config.json)
-  const changesetDir = '.changeset';
-  const changesetFiles = readdirSync(changesetDir).filter(
-    (file) => file.endsWith('.md') && file !== 'README.md'
-  );
-
-  const changesetCount = changesetFiles.length;
-  console.log(`Found ${changesetCount} changeset file(s)`);
-
-  // Ensure exactly one changeset file exists
-  if (changesetCount === 0) {
-    console.error(
-      "::error::No changeset found. Please add a changeset by running 'npm run changeset' and commit the result."
-    );
-    process.exit(1);
-  } else if (changesetCount > 1) {
-    console.error(
-      `::error::Multiple changesets found (${changesetCount}). Each PR should have exactly ONE changeset.`
-    );
-    console.error('::error::Found changeset files:');
-    changesetFiles.forEach((file) => console.error(`  ${file}`));
-    process.exit(1);
-  }
-
-  // Get the changeset file
-  const changesetFile = join(changesetDir, changesetFiles[0]);
-  console.log(`Validating changeset: ${changesetFile}`);
-
-  // Read the changeset file
-  const content = readFileSync(changesetFile, 'utf-8');
-
-  // Check if changeset has a valid type (major, minor, or patch)
-  const versionTypeRegex = new RegExp(
-    `^['"]${PACKAGE_NAME}['"]:\\s+(major|minor|patch)`,
-    'm'
-  );
-  if (!versionTypeRegex.test(content)) {
-    console.error(
-      '::error::Changeset must specify a version type: major, minor, or patch'
-    );
-    console.error(`::error::Expected format in ${changesetFile}:`);
-    console.error('::error::---');
-    console.error(`::error::'${PACKAGE_NAME}': patch`);
-    console.error('::error::---');
-    console.error('::error::');
-    console.error('::error::Your description here');
-    console.error('\nFile content:');
-    console.error(content);
-    process.exit(1);
-  }
-
-  // Extract description (everything after the closing ---) and check it's not empty
-  const parts = content.split('---');
-  if (parts.length < 3) {
-    console.error(
-      '::error::Changeset must include a description of the changes'
-    );
-    console.error(
-      "::error::The description should appear after the closing '---' in the changeset file"
-    );
-    console.error(`::error::Current content of ${changesetFile}:`);
-    console.error(content);
-    process.exit(1);
-  }
-
-  const description = parts.slice(2).join('---').trim();
-  if (!description) {
-    console.error(
-      '::error::Changeset must include a description of the changes'
-    );
-    console.error(
-      "::error::The description should appear after the closing '---' in the changeset file"
-    );
-    console.error(`::error::Current content of ${changesetFile}:`);
-    console.error(content);
-    process.exit(1);
-  }
-
-  // Extract version type
-  const versionTypeMatch = content.match(versionTypeRegex);
-  const versionType = versionTypeMatch ? versionTypeMatch[1] : 'unknown';
-
-  console.log('✅ Changeset validation passed');
-  console.log(`   Type: ${versionType}`);
-  console.log(`   Description: ${description}`);
-} catch (error) {
-  console.error('Error during changeset validation:', error.message);
-  if (process.env.DEBUG) {
-    console.error('Stack trace:', error.stack);
-  }
-  process.exit(1);
-}