@dotdotgod/cli 0.2.14 → 0.2.17

package/src/trello/client.mjs

@@ -1,93 +0,0 @@
-const TRELLO_API_BASE = 'https://api.trello.com';
-
-function clean(value) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-function credentialError(message) {
-  return {
-    ok: false,
-    error: {
-      code: 'TRELLO_CREDENTIALS_MISSING',
-      message: `${message} Fix: configure GitHub Actions secrets or environment variables TRELLO_API_KEY and TRELLO_TOKEN, then retry from the trusted Trello sync workflow.`,
-    },
-  };
-}
-
-export function resolveTrelloCredentials({ env = process.env } = {}) {
-  const apiKey = clean(env.TRELLO_API_KEY);
-  const token = clean(env.TRELLO_TOKEN);
-  if (!apiKey || !token) return credentialError('Trello write mode credentials are missing or empty.');
-  return { ok: true, credentials: { apiKey, token, source: 'env' } };
-}
-
-function trelloApiError({ status = 0, statusText = '', body = '', retryAfter = null, operation = 'Trello API request', idOrShortLink = '', redact = (value) => value } = {}) {
-  const bodyText = redact(typeof body === 'string' ? body : JSON.stringify(body ?? ''));
-  const code = bodyText.includes('API_TOKEN_LIMIT_EXCEEDED') ? 'API_TOKEN_LIMIT_EXCEEDED' : bodyText.includes('API_KEY_LIMIT_EXCEEDED') ? 'API_KEY_LIMIT_EXCEEDED' : 'TRELLO_API_FAILED';
-  const rateLimitGuidance = status === 429 ? ` Wait and retry${retryAfter ? ` after ${retryAfter} seconds` : ''}.` : '';
-  return {
-    code,
-    status,
-    retryAfter,
-    message: `${operation} failed${idOrShortLink ? ` for Trello card ${idOrShortLink}` : ''}${status ? ` with HTTP ${status}${statusText ? ` ${statusText}` : ''}` : ''}${bodyText ? `: ${bodyText}` : ''}. Fix:${rateLimitGuidance || ' check card access, credentials, and Trello response details, then retry.'}`,
-  };
-}
-
-export function createTrelloClient({ credentials, fetchImpl = globalThis.fetch, baseUrl = TRELLO_API_BASE } = {}) {
-  if (typeof fetchImpl !== 'function') throw new Error('Trello client requires a fetch implementation.');
-  const auth = { key: credentials?.apiKey ?? '', token: credentials?.token ?? '' };
-  const redact = (value = '') => String(value).split(auth.key).join('[REDACTED_API_KEY]').split(auth.token).join('[REDACTED_TOKEN]');
-
-  async function request(path, { method = 'GET', params = {}, body = null, operation, idOrShortLink } = {}) {
-    const url = new URL(path, baseUrl);
-    for (const [key, value] of Object.entries({ ...params, ...auth })) url.searchParams.set(key, value);
-    const init = { method };
-    if (body !== null) {
-      init.headers = { 'Content-Type': 'application/json' };
-      init.body = JSON.stringify(body);
-    }
-    let response;
-    try {
-      response = await fetchImpl(url, init);
-    } catch (error) {
-      throw trelloApiError({ operation, idOrShortLink, body: error?.message ?? 'network error', redact });
-    }
-    const bodyText = await response.text();
-    if (!response.ok) {
-      throw trelloApiError({ status: response.status, statusText: response.statusText, body: bodyText, retryAfter: response.headers?.get?.('Retry-After') ?? null, operation, idOrShortLink, redact });
-    }
-    if (!bodyText) return null;
-    try {
-      return JSON.parse(bodyText);
-    } catch {
-      throw trelloApiError({ status: response.status, statusText: response.statusText, body: 'Malformed JSON response', operation, idOrShortLink, redact });
-    }
-  }
-
-  return {
-    async getCard(idOrShortLink) {
-      const card = await request(`/1/cards/${encodeURIComponent(idOrShortLink)}`, { params: { fields: 'id,idBoard,desc', customFieldItems: 'true' }, operation: 'Card lookup', idOrShortLink });
-      if (!card || typeof card.id !== 'string' || typeof card.idBoard !== 'string') throw trelloApiError({ body: 'Malformed card response', operation: 'Card lookup', idOrShortLink, redact });
-      return card;
-    },
-    async listAttachments(idOrShortLink) {
-      const attachments = await request(`/1/cards/${encodeURIComponent(idOrShortLink)}/attachments`, { operation: 'Attachment lookup', idOrShortLink });
-      if (!Array.isArray(attachments)) throw trelloApiError({ body: 'Malformed attachments response', operation: 'Attachment lookup', idOrShortLink, redact });
-      return attachments;
-    },
-    async createAttachment(idOrShortLink, githubUrl) {
-      return request(`/1/cards/${encodeURIComponent(idOrShortLink)}/attachments`, { method: 'POST', params: { url: githubUrl }, operation: 'Attachment creation', idOrShortLink });
-    },
-    async listCustomFields(idBoard) {
-      const fields = await request(`/1/boards/${encodeURIComponent(idBoard)}/customFields`, { operation: 'Custom field lookup' });
-      if (!Array.isArray(fields)) throw trelloApiError({ body: 'Malformed custom fields response', operation: 'Custom field lookup', redact });
-      return fields;
-    },
-    async createCustomField(idBoard, { name, type = 'text' } = {}) {
-      return request('/1/customFields', { method: 'POST', params: { idModel: idBoard, modelType: 'board', name, type, pos: 'bottom', display_cardFront: 'false' }, operation: 'Custom field creation' });
-    },
-    async updateCardCustomFieldText(idCard, idCustomField, text) {
-      return request(`/1/cards/${encodeURIComponent(idCard)}/customField/${encodeURIComponent(idCustomField)}/item`, { method: 'PUT', body: { value: { text } }, operation: 'Custom field update', idOrShortLink: idCard });
-    },
-  };
-}

package/src/trello/custom-fields.mjs

@@ -1,102 +0,0 @@
-export const DEFAULT_DOTDOTGOD_CUSTOM_FIELD_NAME = 'dotdotgod-view';
-
-function cleanString(value) {
-  return typeof value === 'string' ? value.trim() : '';
-}
-
-export function dotdotgodCustomFieldName({ env = process.env, name = '' } = {}) {
-  return cleanString(name) || cleanString(env.DOTDOTGOD_TRELLO_CUSTOM_FIELD_NAME) || DEFAULT_DOTDOTGOD_CUSTOM_FIELD_NAME;
-}
-
-function buildLinkedDocsCustomFieldData({ docsPath, githubUrl, trelloUrl, repositoryKey, repositoryLabel, title, summary, traceabilityState, traceabilityDetails = [] } = {}) {
-  return {
-    repositoryKey: cleanString(repositoryKey),
-    repositoryLabel: cleanString(repositoryLabel) || cleanString(repositoryKey).split('/').filter(Boolean).at(-1) || '',
-    docsPath: cleanString(docsPath),
-    githubUrl: cleanString(githubUrl),
-    trelloUrl: cleanString(trelloUrl),
-    title: cleanString(title),
-    summary: cleanString(summary),
-    traceabilityState: cleanString(traceabilityState) || 'not_required',
-    traceabilityDetails: Array.isArray(traceabilityDetails) ? traceabilityDetails.map((item) => String(item)) : [],
-  };
-}
-
-export function serializeLinkedDocsCustomFieldPayload(entries = []) {
-  return JSON.stringify({ version: 1, entries: entries.map((entry) => buildLinkedDocsCustomFieldData(entry)) });
-}
-
-export function parseLinkedDocsCustomFieldPayload(text = '') {
-  const value = cleanString(text);
-  if (!value) return { ok: true, entries: [] };
-  let parsed;
-  try {
-    parsed = JSON.parse(value);
-  } catch (error) {
-    return {
-      ok: false,
-      error: {
-        code: 'TRELLO_CUSTOM_FIELD_INVALID',
-        message: `dotdotgod custom field contains invalid JSON. Cause: ${error.message}. Fix: clear the custom field or restore a valid dotdotgod linked-docs payload, then retry sync.`,
-      },
-    };
-  }
-  if (!parsed || parsed.version !== 1 || !Array.isArray(parsed.entries)) {
-    return {
-      ok: false,
-      error: {
-        code: 'TRELLO_CUSTOM_FIELD_INVALID',
-        message: 'dotdotgod custom field has an unsupported shape. Fix: clear the custom field or restore a version 1 linked-docs payload with an entries array, then retry sync.',
-      },
-    };
-  }
-  const entries = parsed.entries.map((entry) => buildLinkedDocsCustomFieldData(entry));
-  const keys = entries.map((entry) => entry.repositoryKey).filter(Boolean);
-  if (keys.length !== new Set(keys).size) {
-    return {
-      ok: false,
-      error: {
-        code: 'TRELLO_CUSTOM_FIELD_DUPLICATE_REPOSITORY',
-        message: 'dotdotgod custom field contains duplicate repository entries. Fix: keep one entry per repository key, then retry sync.',
-      },
-    };
-  }
-  return { ok: true, entries };
-}
-
-export function mergeLinkedDocsCustomFieldValue(existingText = '', entry = {}) {
-  const current = buildLinkedDocsCustomFieldData(entry);
-  if (!current.repositoryKey) {
-    return {
-      ok: false,
-      error: {
-        code: 'TRELLO_CUSTOM_FIELD_REPOSITORY_MISSING',
-        message: 'Cannot update dotdotgod custom field without a repository key. Fix: run from a trusted GitHub Actions repository or configure repository metadata, then retry sync.',
-      },
-    };
-  }
-  const parsed = parseLinkedDocsCustomFieldPayload(existingText);
-  if (!parsed.ok) return parsed;
-  const entries = [...parsed.entries];
-  const index = entries.findIndex((item) => item.repositoryKey === current.repositoryKey);
-  let action = 'create-payload';
-  if (index >= 0) {
-    const before = JSON.stringify(entries[index]);
-    const after = JSON.stringify(current);
-    action = before === after ? 'unchanged-entry' : 'replace-entry';
-    entries[index] = current;
-  } else if (entries.length > 0) {
-    action = 'append-entry';
-    entries.push(current);
-  } else {
-    entries.push(current);
-  }
-  const text = serializeLinkedDocsCustomFieldPayload(entries);
-  const status = cleanString(existingText) === text ? 'unchanged' : 'written';
-  return { ok: true, status, action: status === 'unchanged' ? 'unchanged-entry' : action, text, entries, preservedRepositoryEntries: entries.filter((item) => item.repositoryKey !== current.repositoryKey).length };
-}
-
-export function customFieldTextValue(card = {}, idCustomField = '') {
-  const item = Array.isArray(card.customFieldItems) ? card.customFieldItems.find((fieldItem) => fieldItem?.idCustomField === idCustomField) : null;
-  return typeof item?.value?.text === 'string' ? item.value.text : '';
-}

package/src/trello/github-url.mjs

@@ -1,107 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { spawnSync } from 'node:child_process';
-import { join } from 'node:path';
-
-function normalizeGitHubRepositoryKey(value = '') {
-  const text = String(value).trim();
-  const match = text.match(/^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/u);
-  if (!match) return null;
-  return `${match[1]}/${match[2]}`;
-}
-
-export function normalizeGitHubRemote(value = '') {
-  const text = String(value).trim();
-  if (!text) return null;
-  let match = text.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/u);
-  if (match) return { repositoryUrl: `https://github.com/${match[1]}/${match[2]}`, repositoryKey: `${match[1]}/${match[2]}` };
-  match = text.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/u);
-  if (match) return { repositoryUrl: `https://github.com/${match[1]}/${match[2]}`, repositoryKey: `${match[1]}/${match[2]}` };
-  return null;
-}
-
-function encodePath(path = '') {
-  return path.split('/').map((part) => encodeURIComponent(part)).join('/');
-}
-
-function repositoryFromPackage(root) {
-  try {
-    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
-    const raw = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url;
-    return normalizeGitHubRemote(String(raw ?? '').replace(/^git\+/, ''));
-  } catch {
-    return null;
-  }
-}
-
-function gitValue(root, args) {
-  const result = spawnSync('git', args, { cwd: root, encoding: 'utf8' });
-  if (result.status !== 0) return '';
-  return result.stdout.trim();
-}
-
-function repositoryResult(repositoryUrl, repositoryKey, source, warnings = []) {
-  return { ok: true, repositoryUrl, repositoryKey, source, warnings, errors: [] };
-}
-
-export function resolveGitHubRepositoryIdentity({ root = '.', repository, repositoryUrl, remoteUrl, env = process.env, git = true, mode = 'dry-run' } = {}) {
-  const warnings = [];
-  const explicitKey = normalizeGitHubRepositoryKey(repository);
-  if (explicitKey) return repositoryResult(`https://github.com/${explicitKey}`, explicitKey, 'explicit-repository', warnings);
-
-  const explicitRemote = normalizeGitHubRemote(repositoryUrl);
-  if (explicitRemote) return repositoryResult(explicitRemote.repositoryUrl, explicitRemote.repositoryKey, 'explicit-repository-url', warnings);
-
-  const actionsKey = normalizeGitHubRepositoryKey(env?.GITHUB_REPOSITORY);
-  if (actionsKey) return repositoryResult(`https://github.com/${actionsKey}`, actionsKey, 'github-actions', warnings);
-  if (mode === 'write' && env?.GITHUB_REPOSITORY && !actionsKey) {
-    return { ok: false, repositoryUrl: '', repositoryKey: '', source: '', warnings, errors: [{ code: 'GITHUB_REPOSITORY_KEY_INVALID', message: 'Could not resolve a valid GitHub repository key from GITHUB_REPOSITORY. Fix: run the trusted workflow with GITHUB_REPOSITORY in owner/name form, then retry sync.' }] };
-  }
-
-  const injectedRemote = normalizeGitHubRemote(remoteUrl);
-  if (injectedRemote) {
-    warnings.push({ code: 'GITHUB_URL_REMOTE_FALLBACK', message: 'GitHub URL resolved from injected git remote fallback.' });
-    return repositoryResult(injectedRemote.repositoryUrl, injectedRemote.repositoryKey, 'remote-url', warnings);
-  }
-
-  if (mode !== 'write') {
-    const packageRepo = repositoryFromPackage(root);
-    if (packageRepo) {
-      warnings.push({ code: 'GITHUB_URL_PACKAGE_FALLBACK', message: 'GitHub URL resolved from package repository metadata.' });
-      return repositoryResult(packageRepo.repositoryUrl, packageRepo.repositoryKey, 'package', warnings);
-    }
-    if (git) {
-      const remote = gitValue(root, ['remote', 'get-url', 'origin']);
-      const gitRepo = normalizeGitHubRemote(remote);
-      if (gitRepo) {
-        warnings.push({ code: 'GITHUB_URL_GIT_REMOTE_FALLBACK', message: 'GitHub URL resolved from local git origin remote.' });
-        return repositoryResult(gitRepo.repositoryUrl, gitRepo.repositoryKey, 'git-remote', warnings);
-      }
-    }
-  }
-
-  const code = mode === 'write' ? 'GITHUB_REPOSITORY_KEY_UNRESOLVED' : 'GITHUB_URL_UNRESOLVED_REPOSITORY';
-  const message = mode === 'write'
-    ? 'Could not resolve a trusted GitHub repository key for Trello custom field entry. Fix: run write mode from GitHub Actions with GITHUB_REPOSITORY or provide explicit GitHub repository metadata, then retry sync.'
-    : 'Could not resolve a GitHub repository URL.';
-  return { ok: false, repositoryUrl: '', repositoryKey: '', source: '', warnings, errors: [{ code, message }] };
-}
-
-export function resolveGitHubFileUrl({ root = '.', file, repository, repositoryUrl, branch, remoteUrl, env = process.env, git = true, mode = 'dry-run' } = {}) {
-  const identity = resolveGitHubRepositoryIdentity({ root, repository, repositoryUrl, remoteUrl, env, git, mode });
-  const warnings = [...(identity.warnings ?? [])];
-  let resolvedBranch = branch;
-  if (!resolvedBranch && mode === 'write') {
-    if (env?.GITHUB_REF_NAME) resolvedBranch = env.GITHUB_REF_NAME;
-    else if (typeof env?.GITHUB_REF === 'string' && env.GITHUB_REF.startsWith('refs/heads/')) resolvedBranch = env.GITHUB_REF.slice('refs/heads/'.length);
-    else if (env?.GITHUB_DEFAULT_BRANCH) resolvedBranch = env.GITHUB_DEFAULT_BRANCH;
-  }
-  if (!resolvedBranch && git && mode !== 'write') {
-    resolvedBranch = gitValue(root, ['branch', '--show-current']);
-    if (resolvedBranch) warnings.push({ code: 'GITHUB_URL_GIT_BRANCH_FALLBACK', message: 'GitHub branch resolved from local git state.' });
-  }
-  const errors = [];
-  if (!identity.ok) errors.push(...identity.errors);
-  if (!resolvedBranch) errors.push({ code: 'GITHUB_URL_UNRESOLVED_BRANCH', message: 'Could not resolve a GitHub branch.' });
-  if (errors.length > 0) return { ok: false, url: '', repositoryKey: identity.repositoryKey ?? '', repositoryUrl: identity.repositoryUrl ?? '', warnings, errors };
-  return { ok: true, url: `${identity.repositoryUrl}/blob/${encodeURIComponent(resolvedBranch)}/${encodePath(file)}`, repositoryKey: identity.repositoryKey, repositoryUrl: identity.repositoryUrl, warnings, errors: [] };
-}

package/src/trello/metadata.mjs

@@ -1,52 +0,0 @@
-const TRELLO_KEYS = new Set(['trelloUrl', 'trelloShortLink', 'trelloCardId']);
-
-export function parseFrontmatter(content = '') {
-  if (!String(content).startsWith('---\n')) return { data: {}, errors: [] };
-  const end = String(content).indexOf('\n---', 4);
-  if (end === -1) return { data: {}, errors: [{ code: 'TRELLO_FRONTMATTER_INVALID', message: 'Frontmatter start marker is missing a closing marker.' }] };
-  const raw = String(content).slice(4, end).split('\n');
-  const data = {};
-  const errors = [];
-  for (const [index, line] of raw.entries()) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const match = trimmed.match(/^([A-Za-z0-9_-]+)\s*:\s*(.*)$/);
-    if (!match) continue;
-    const key = match[1];
-    let value = match[2].trim();
-    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) value = value.slice(1, -1);
-    if (Object.hasOwn(data, key)) errors.push({ code: 'TRELLO_FRONTMATTER_DUPLICATE_KEY', message: `Duplicate frontmatter key: ${key}.`, line: index + 2 });
-    data[key] = value;
-  }
-  return { data, errors };
-}
-
-export function extractTrelloShortLink(trelloUrl = '') {
-  let url;
-  try {
-    url = new URL(trelloUrl);
-  } catch {
-    return null;
-  }
-  if (url.protocol !== 'https:' || url.hostname !== 'trello.com') return null;
-  const parts = url.pathname.split('/').filter(Boolean);
-  if (parts[0] !== 'c' || !parts[1] || parts.length > 3) return null;
-  return parts[1];
-}
-
-export function parseTrelloMetadata(content = '') {
-  const { data, errors } = parseFrontmatter(content);
-  const warnings = [];
-  const unsupported = [...TRELLO_KEYS].filter((key) => key !== 'trelloUrl' && Object.hasOwn(data, key));
-  const trelloUrl = typeof data.trelloUrl === 'string' ? data.trelloUrl.trim() : '';
-  if (unsupported.length > 0) {
-    warnings.push({ code: 'TRELLO_UNSUPPORTED_METADATA', message: `Unsupported Trello metadata ignored in Phase 1: ${unsupported.join(', ')}. Use trelloUrl only.` });
-  }
-  if (!trelloUrl) {
-    errors.push({ code: 'TRELLO_METADATA_MISSING_URL', message: 'Missing required frontmatter field: trelloUrl.' });
-    return { ok: false, trelloUrl: '', shortLink: '', warnings, errors };
-  }
-  const shortLink = extractTrelloShortLink(trelloUrl);
-  if (!shortLink) errors.push({ code: 'TRELLO_METADATA_INVALID_URL', message: 'trelloUrl must match https://trello.com/c/<shortLink>/ or https://trello.com/c/<shortLink>/<slug>.' });
-  return { ok: errors.length === 0, trelloUrl, shortLink: shortLink ?? '', warnings, errors };
-}

package/src/trello/report.mjs

@@ -1,60 +0,0 @@
-function plural(value, label) {
-  return `${value} ${label}${value === 1 ? '' : 's'}`;
-}
-
-function pushMessages(lines, label, messages, indent = '') {
-  if ((messages ?? []).length === 0) return;
-  lines.push(`${indent}${label}:`);
-  for (const message of messages) lines.push(`${indent}  - ${message.code}: ${message.message}`);
-}
-
-export function formatTrelloDryRunReport(report) {
-  const lines = ['Trello docs sync dry-run'];
-  lines.push(`Root: ${report.root}`);
-  lines.push(`Scan paths: ${report.scanPaths.join(', ')}`);
-  lines.push(`Matched: ${plural(report.totals.matchedFiles, 'file')}; planned: ${plural(report.totals.plannedUpdates, 'update')}; warnings: ${report.totals.warnings}; errors: ${report.totals.errors}`);
-  pushMessages(lines, 'Warnings', report.warnings);
-  pushMessages(lines, 'Errors', report.errors);
-  for (const file of report.files) {
-    lines.push('');
-    lines.push(`File: ${file.file}`);
-    lines.push(`  Trello URL: ${file.trelloUrl || '(missing)'}`);
-    if (file.shortLink) lines.push(`  Trello short link: ${file.shortLink}`);
-    lines.push(`  GitHub URL: ${file.githubUrl || '(unresolved)'}`);
-    if (file.repositoryKey) lines.push(`  Repository entry: ${file.repositoryKey}`);
-    lines.push(`  Planned attachment: ${file.plannedAttachmentAction}`);
-    lines.push(`  Planned custom field: ${file.plannedCustomFieldAction}`);
-    lines.push(`  Sync status: ${file.syncStatus}`);
-    lines.push(`  Traceability: ${file.traceability.state}${file.traceability.details.length ? ` (${file.traceability.details.join(', ')})` : ''}`);
-    pushMessages(lines, 'Warnings', file.warnings, '  ');
-    pushMessages(lines, 'Errors', file.errors, '  ');
-  }
-  return `${lines.join('\n')}\n`;
-}
-
-export function formatTrelloWriteReport(report) {
-  const lines = ['Trello docs sync write'];
-  lines.push(`Root: ${report.root}`);
-  lines.push(`Scan paths: ${report.scanPaths.join(', ')}`);
-  lines.push(`Matched: ${plural(report.totals.matchedFiles, 'file')}; written: ${report.totals.written}; unchanged: ${report.totals.unchanged}; blocked: ${report.totals.blocked}; conflict: ${report.totals.conflict}; api-failed: ${report.totals.apiFailed}; warnings: ${report.totals.warnings}; errors: ${report.totals.errors}`);
-  pushMessages(lines, 'Warnings', report.warnings);
-  pushMessages(lines, 'Errors', report.errors);
-  for (const file of report.files) {
-    lines.push('');
-    lines.push(`File: ${file.file}`);
-    lines.push(`  Trello URL: ${file.trelloUrl || '(missing)'}`);
-    if (file.shortLink) lines.push(`  Trello short link: ${file.shortLink}`);
-    lines.push(`  GitHub URL: ${file.githubUrl || '(unresolved)'}`);
-    if (file.repositoryKey) lines.push(`  Repository entry: ${file.repositoryKey}`);
-    lines.push(`  Attachment: ${file.attachment?.status ?? 'not-run'}`);
-    const customFieldAction = file.customField?.action ? ` (${file.customField.action})` : '';
-    lines.push(`  Custom field: ${file.customField?.status ?? 'not-run'}${customFieldAction}`);
-    if (file.customField?.name) lines.push(`  Custom field name: ${file.customField.name}`);
-    if (file.customField?.preservedRepositoryEntries > 0) lines.push(`  Preserved repository entries: ${file.customField.preservedRepositoryEntries}`);
-    lines.push(`  Final status: ${file.finalStatus ?? file.syncStatus}`);
-    lines.push(`  Traceability: ${file.traceability.state}${file.traceability.details.length ? ` (${file.traceability.details.join(', ')})` : ''}`);
-    pushMessages(lines, 'Warnings', file.warnings, '  ');
-    pushMessages(lines, 'Errors', file.errors, '  ');
-  }
-  return `${lines.join('\n')}\n`;
-}

package/src/trello/summary.mjs

@@ -1,60 +0,0 @@
-import { extractDotdotgodTraceabilityBlocks, validateTraceabilityBlock } from '../docs/traceability.mjs';
-import { requiresTraceability } from '../memory/config.mjs';
-
-export function summarizeTraceability({ content = '', root = '.', file = '', config } = {}) {
-  const blocks = extractDotdotgodTraceabilityBlocks(content);
-  if (blocks.some((block) => block.error)) {
-    return { state: 'invalid', details: blocks.filter((block) => block.error).map((block) => `Invalid JSON at line ${block.line}: ${block.error}`), errors: [{ code: 'TRELLO_TRACEABILITY_INVALID', message: 'Malformed json dotdotgod traceability block.' }] };
-  }
-  if (blocks.length === 0) {
-    const required = requiresTraceability(file, config);
-    return { state: required ? 'missing' : 'not_required', details: [], errors: required ? [{ code: 'TRELLO_TRACEABILITY_MISSING', message: 'Missing required json dotdotgod traceability block.' }] : [] };
-  }
-  const errors = blocks.flatMap((block) => validateTraceabilityBlock(block.data, root, file, block.line, config));
-  if (errors.length > 0) return { state: 'invalid', details: errors.map((error) => `${error.code}: ${error.message.split('\n')[0]}`), errors: [{ code: 'TRELLO_TRACEABILITY_INVALID', message: 'Invalid json dotdotgod traceability block.' }] };
-  const latest = blocks.at(-1).data;
-  const details = [];
-  if (Array.isArray(latest.implementedBy) && latest.implementedBy.length > 0) details.push(`implementedBy: ${latest.implementedBy.length}`);
-  if (Array.isArray(latest.verifiedBy) && latest.verifiedBy.length > 0) details.push(`verifiedBy: ${latest.verifiedBy.length}`);
-  if (Array.isArray(latest.relatedDocs) && latest.relatedDocs.length > 0) details.push(`relatedDocs: ${latest.relatedDocs.length}`);
-  return { state: 'present', details, errors: [] };
-}
-
-function stripFrontmatter(content = '') {
-  return String(content).replace(/^---\n[\s\S]*?\n---\n?/u, '');
-}
-
-function stripCodeBlocks(content = '') {
-  return String(content).replace(/```[\s\S]*?```/gu, '');
-}
-
-function compactText(value = '', maxLength = 280) {
-  const compact = String(value).replace(/\s+/gu, ' ').trim();
-  if (compact.length <= maxLength) return compact;
-  return `${compact.slice(0, maxLength - 1).trimEnd()}…`;
-}
-
-export function summarizeMarkdownPreview({ content = '', file = '' } = {}) {
-  const body = stripCodeBlocks(stripFrontmatter(content));
-  const lines = body.split(/\r?\n/u).map((line) => line.trim());
-  const title = lines.find((line) => /^#\s+\S/u.test(line))?.replace(/^#\s+/u, '').trim() || file.split('/').at(-1)?.replace(/\.md$/u, '') || '';
-  const summary = compactText(lines.find((line) => line && !line.startsWith('#') && !line.startsWith('<!--') && !line.startsWith('- ') && !line.startsWith('|')) ?? '');
-  return { title: compactText(title, 120), summary };
-}
-
-export function buildLinkedDocsData({ file, content = '', githubUrl, trelloUrl, syncStatus, traceability, repositoryKey } = {}) {
-  const preview = summarizeMarkdownPreview({ content, file });
-  return {
-    docsPath: file,
-    githubUrl,
-    trelloUrl,
-    syncStatus,
-    repositoryKey,
-    repositoryLabel: String(repositoryKey ?? '').split('/').filter(Boolean).at(-1) || '',
-    title: preview.title,
-    summary: preview.summary,
-    traceabilityState: traceability?.state ?? 'not_required',
-    traceabilityDetails: [...(traceability?.details ?? [])],
-  };
-}
-