draftgo-cli 3.0.55 → 4.0.1

package/src/changelog.js

@@ -1,276 +0,0 @@
-'use strict';
-
-const crypto = require('crypto');
-const fs = require('fs');
-const path = require('path');
-const { dgDir } = require('./paths');
-
-const DEFAULT_LOCK_TIMEOUT_MS = 10_000;
-const DEFAULT_LOCK_STALE_MS = 60_000;
-const DEFAULT_LOCK_RETRY_MS = 10;
-const LOCK_WAIT_ARRAY = new Int32Array(new SharedArrayBuffer(4));
-
-class ChangelogFormatError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = 'ChangelogFormatError';
-    this.code = 'INVALID_CHANGELOG';
-  }
-}
-
-function changelogPath(projectDir) {
-  return path.join(dgDir(projectDir), 'changelog.md');
-}
-
-function formatLocalDate(value = new Date()) {
-  if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
-    throw new TypeError('A valid Date is required.');
-  }
-  const year = String(value.getFullYear()).padStart(4, '0');
-  const month = String(value.getMonth() + 1).padStart(2, '0');
-  const day = String(value.getDate()).padStart(2, '0');
-  return `${year}-${month}-${day}`;
-}
-
-function isLeapYear(year) {
-  return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
-}
-
-function isCalendarDate(value) {
-  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
-  if (!match) return false;
-  const year = Number(match[1]);
-  const month = Number(match[2]);
-  const day = Number(match[3]);
-  if (year < 1 || month < 1 || month > 12 || day < 1) return false;
-  const days = [31, isLeapYear(year) ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-  return day <= days[month - 1];
-}
-
-function normalizeMessage(value) {
-  const message = value == null ? '' : String(value).trim();
-  if (!message) throw new TypeError('Changelog result must not be empty.');
-  if (/[\r\n\u2028\u2029]/.test(message)) {
-    throw new TypeError('Changelog result must be a single line.');
-  }
-  return message;
-}
-
-function invalidFormat(detail) {
-  return new ChangelogFormatError(`Invalid .draftgo/changelog.md: ${detail}`);
-}
-
-function parseChangelog(source) {
-  if (typeof source !== 'string') throw new TypeError('Changelog source must be a string.');
-  if (source === '') return [];
-  if (/\r(?!\n)/.test(source)) throw invalidFormat('unsupported line ending.');
-
-  const normalized = source.replace(/\r\n/g, '\n');
-  const body = normalized.endsWith('\n') ? normalized.slice(0, -1) : normalized;
-  const lines = body.split('\n');
-  const blocks = [];
-  let cursor = 0;
-
-  while (cursor < lines.length) {
-    const date = lines[cursor];
-    if (!isCalendarDate(date)) throw invalidFormat(`expected a YYYY-MM-DD header at line ${cursor + 1}.`);
-    if (blocks.length && date <= blocks[blocks.length - 1].date) {
-      throw invalidFormat(`date blocks must be strictly increasing (line ${cursor + 1}).`);
-    }
-    cursor += 1;
-    if (lines[cursor] !== '===') throw invalidFormat(`expected === at line ${cursor + 1}.`);
-    cursor += 1;
-
-    const entries = [];
-    while (cursor < lines.length && lines[cursor] !== '') {
-      const match = /^([1-9]\d*)\. (.+)$/.exec(lines[cursor]);
-      if (!match) throw invalidFormat(`invalid entry at line ${cursor + 1}.`);
-      const number = Number(match[1]);
-      if (!Number.isSafeInteger(number) || number !== entries.length + 1) {
-        throw invalidFormat(`entries must be consecutively numbered from 1 (line ${cursor + 1}).`);
-      }
-      let message;
-      try {
-        message = normalizeMessage(match[2]);
-      } catch (error) {
-        throw invalidFormat(`${error.message} (line ${cursor + 1}).`);
-      }
-      if (message !== match[2]) throw invalidFormat(`entry has surrounding whitespace at line ${cursor + 1}.`);
-      entries.push({ number, message });
-      cursor += 1;
-    }
-    if (!entries.length) throw invalidFormat(`date block ${date} has no entries.`);
-    blocks.push({ date, entries });
-
-    if (cursor >= lines.length) break;
-    cursor += 1;
-    if (cursor >= lines.length || lines[cursor] === '') {
-      throw invalidFormat(`date blocks must be separated by exactly one blank line (line ${cursor + 1}).`);
-    }
-  }
-
-  return blocks;
-}
-
-function renderChangelog(blocks) {
-  if (!Array.isArray(blocks)) throw new TypeError('Changelog blocks must be an array.');
-  if (!blocks.length) return '';
-  return `${blocks.map((block) => [
-    block.date,
-    '===',
-    ...block.entries.map((entry) => `${entry.number}. ${entry.message}`),
-  ].join('\n')).join('\n\n')}\n`;
-}
-
-function appendChangelogEntry(source, value, now = new Date()) {
-  const message = normalizeMessage(value);
-  const date = formatLocalDate(now);
-  const blocks = parseChangelog(source);
-  const last = blocks[blocks.length - 1];
-
-  if (last && date < last.date) {
-    throw new ChangelogFormatError(
-      `Cannot append ${date}: the latest changelog block is ${last.date}. Check the local clock.`
-    );
-  }
-
-  let number;
-  if (last && last.date === date) {
-    number = last.entries.length + 1;
-    last.entries.push({ number, message });
-  } else {
-    number = 1;
-    blocks.push({ date, entries: [{ number, message }] });
-  }
-
-  return { content: renderChangelog(blocks), date, number, message };
-}
-
-function temporaryPath(destination) {
-  const suffix = crypto.randomBytes(8).toString('hex');
-  return path.join(path.dirname(destination), `.${path.basename(destination)}.${process.pid}.${suffix}.tmp`);
-}
-
-function lockOption(value, fallback, name, allowZero = false) {
-  const number = value == null ? fallback : Number(value);
-  const minimum = allowZero ? 0 : 1;
-  if (!Number.isSafeInteger(number) || number < minimum) {
-    throw new TypeError(`${name} must be an integer greater than or equal to ${minimum}.`);
-  }
-  return number;
-}
-
-function removeStaleLock(lockPath, staleMs) {
-  try {
-    const stat = fs.lstatSync(lockPath);
-    if (Date.now() - stat.mtimeMs < staleMs) return false;
-    fs.rmSync(lockPath, { force: true });
-    return true;
-  } catch (error) {
-    if (error && error.code === 'ENOENT') return true;
-    throw error;
-  }
-}
-
-function acquireChangelogLock(destination, options = {}) {
-  fs.mkdirSync(path.dirname(destination), { recursive: true });
-  const lockPath = `${destination}.lock`;
-  const timeoutMs = lockOption(
-    options.lockTimeoutMs,
-    DEFAULT_LOCK_TIMEOUT_MS,
-    'lockTimeoutMs',
-    true,
-  );
-  const staleMs = lockOption(options.lockStaleMs, DEFAULT_LOCK_STALE_MS, 'lockStaleMs');
-  const retryMs = lockOption(options.lockRetryMs, DEFAULT_LOCK_RETRY_MS, 'lockRetryMs');
-  const token = `${process.pid}:${crypto.randomBytes(16).toString('hex')}`;
-  const started = Date.now();
-
-  while (true) {
-    let descriptor;
-    let created = false;
-    try {
-      descriptor = fs.openSync(lockPath, 'wx', 0o600);
-      created = true;
-      fs.writeFileSync(descriptor, `${token}\n`, 'utf8');
-      fs.fsyncSync(descriptor);
-      fs.closeSync(descriptor);
-      descriptor = undefined;
-      return { path: lockPath, token };
-    } catch (error) {
-      if (descriptor !== undefined) {
-        try { fs.closeSync(descriptor); } catch { /* Preserve the original failure. */ }
-      }
-      if (created) {
-        try { fs.rmSync(lockPath, { force: true }); } catch { /* Best-effort cleanup. */ }
-      }
-      if (!error || error.code !== 'EEXIST') throw error;
-    }
-
-    if (removeStaleLock(lockPath, staleMs)) continue;
-    const elapsed = Date.now() - started;
-    if (elapsed >= timeoutMs) {
-      const error = new Error('Timed out waiting for .draftgo/changelog.md.lock.');
-      error.code = 'CHANGELOG_LOCK_TIMEOUT';
-      throw error;
-    }
-    Atomics.wait(LOCK_WAIT_ARRAY, 0, 0, Math.min(retryMs, timeoutMs - elapsed));
-  }
-}
-
-function releaseChangelogLock(lock) {
-  try {
-    const token = fs.readFileSync(lock.path, 'utf8').trim();
-    if (token === lock.token) fs.rmSync(lock.path, { force: true });
-  } catch (error) {
-    if (!error || error.code !== 'ENOENT') throw error;
-  }
-}
-
-function writeTextAtomic(destination, content) {
-  fs.mkdirSync(path.dirname(destination), { recursive: true });
-  const temporary = temporaryPath(destination);
-  let descriptor;
-  try {
-    descriptor = fs.openSync(temporary, 'wx', 0o666);
-    fs.writeFileSync(descriptor, content, 'utf8');
-    fs.fsyncSync(descriptor);
-    fs.closeSync(descriptor);
-    descriptor = undefined;
-    fs.renameSync(temporary, destination);
-  } finally {
-    if (descriptor !== undefined) {
-      try { fs.closeSync(descriptor); } catch { /* The original error is more useful. */ }
-    }
-    try { fs.rmSync(temporary, { force: true }); } catch { /* Best-effort temporary cleanup. */ }
-  }
-}
-
-function addChangelogEntry(projectDir, value, options = {}) {
-  const file = changelogPath(projectDir);
-  const message = normalizeMessage(value);
-  const lock = acquireChangelogLock(file, options);
-  try {
-    const source = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : '';
-    const result = appendChangelogEntry(source, message, options.now || new Date());
-    writeTextAtomic(file, result.content);
-    return { ...result, path: file };
-  } finally {
-    releaseChangelogLock(lock);
-  }
-}
-
-module.exports = {
-  ChangelogFormatError,
-  changelogPath,
-  formatLocalDate,
-  isCalendarDate,
-  normalizeMessage,
-  parseChangelog,
-  renderChangelog,
-  appendChangelogEntry,
-  acquireChangelogLock,
-  releaseChangelogLock,
-  writeTextAtomic,
-  addChangelogEntry,
-};

package/src/commands/changelog.js

@@ -1,24 +0,0 @@
-'use strict';
-
-const log = require('../logger');
-const { addChangelogEntry } = require('../changelog');
-
-function printUsage() {
-  log.err('Usage: draftgo changelog add <completed-result>');
-}
-
-function changelog(projectDir, positional = []) {
-  const [action, ...messageParts] = positional;
-  if (action !== 'add' || !messageParts.length) {
-    printUsage();
-    return 1;
-  }
-
-  const result = addChangelogEntry(projectDir, messageParts.join(' '));
-  log.ok(`Changelog updated: .draftgo/changelog.md (${result.date} #${result.number})`);
-  return 0;
-}
-
-changelog.printUsage = printUsage;
-
-module.exports = changelog;

package/src/commands/localDev.js

@@ -1,9 +0,0 @@
-'use strict';
-
-const { runWizard } = require('../localdev');
-
-async function localDev(projectDir, positional, flags) {
-  return runWizard(projectDir, { yes: !!(flags.yes || flags.y) });
-}
-
-module.exports = localDev;

package/src/commands/sync.js

@@ -1,46 +0,0 @@
-'use strict';
-
-const log = require('../logger');
-const { canonicalResourceType } = require('../worktree/types');
-
-async function sync(projectDir, command, positional, flags = {}) {
-  if (command === 'pull') {
-    log.err('`draftgo pull` no longer downloads DraftGo resources.');
-    log.dim('  Use MCP project/resource discovery. For complete pages, navigation, or docs, use `draftgo checkout <type> <id...>`.');
-    log.dim('  Existing legacy .draftgo indexes are left untouched and ignored.');
-    return 1;
-  }
-
-  const [rawType, ...ids] = positional;
-  if (!rawType) {
-    log.err('The legacy push-all workflow has been removed.');
-    log.dim('  Use `draftgo commit <pages|nav|docs> <id...>` for checked-out long content.');
-    log.dim('  Use DraftGo MCP for structured resources.');
-    return 1;
-  }
-
-  let resourceType;
-  try {
-    resourceType = canonicalResourceType(rawType);
-  } catch {
-    log.err(`Legacy push for ${rawType} is no longer supported.`);
-    log.dim('  Discover the live API with `draftgo api <query>` and use MCP api_call for structured resources.');
-    return 1;
-  }
-  if (!ids.length) {
-    log.err('Refusing legacy push-all behavior; specify checked-out resource ids explicitly.');
-    return 1;
-  }
-
-  log.warn('`draftgo push` is deprecated; forwarding checked-out long content to `draftgo commit`.');
-  if (flags['dry-run']) {
-    for (const id of ids) {
-      const code = require('./diff')(projectDir, [resourceType, id], flags);
-      if (code !== 0) return code;
-    }
-    return 0;
-  }
-  return require('./commit')(projectDir, [resourceType, ...ids], flags);
-}
-
-module.exports = sync;