@dotdotgod/cli 0.2.14 → 0.2.15

package/README.md

@@ -40,7 +40,6 @@ dotdotgod graph impact . --changed <path> --compact
 - `resolve` and `expand` map explicit or high-signal prompt references to project files.
 - `graph impact` ranks likely related specs, tests, docs, commands, and source files for one or more changed paths, with a combined ranking and per-file top five.
 - `traceability links` checks or repairs generated Markdown traceability-link sections.
-- `trello sync` plans or writes Trello linked-doc metadata from configured docs paths.
 
 ## Commands
 
@@ -77,7 +76,6 @@ dotdotgod graph communities .
 | Resolve `[[...]]` references from a prompt | `dotdotgod expand . "Update [[PLAN_MODE]]"` |
 | Repair generated traceability-link sections | `dotdotgod traceability links . --write` |
 | See what else to inspect after a change | `dotdotgod graph impact . --changed <path> --compact` |
-| Preview Trello linked-doc updates | `dotdotgod trello sync . --dry-run` |
 
 ## Changed-File Impact
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/cli",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "CLI for dotdotgod validation, local documentation search, and graph indexing.",
   "type": "module",
   "license": "Elastic-2.0",

package/src/cli/usage.mjs

@@ -42,20 +42,6 @@ Search shared project documentation with the local multilingual E5 vector index.
     case 'expand':
       return `Usage:
   dotdotgod expand <root> <prompt> [--max-results n] [--include-archive] [--with-impact] [--fuzzy] [--json]`;
-    case 'trello':
-      return `Usage:
-  dotdotgod trello sync <root> [--dry-run]`;
-    case 'trello sync':
-      return `Usage:
-  dotdotgod trello sync <root> [--dry-run]
-
-Options:
-  --dry-run  Preview planned Trello updates without calling Trello APIs.
-
-Write mode:
-  Omit --dry-run only in the trusted GitHub Actions default-branch push workflow.
-  Requires TRELLO_API_KEY and TRELLO_TOKEN in the trusted workflow environment.
-  Local/manual and pull request usage should run --dry-run.`;
     case 'traceability':
       return `Usage:
   dotdotgod traceability links <root> [--check|--write] [--json]`;
@@ -95,7 +81,6 @@ Commands:
   traceability links    Check or write generated traceability links.
   graph impact          Find files related to changed files.
   graph communities     Find groups of related project-memory nodes.
-  trello sync           Synchronize Trello cards and documentation.
 
 Options:
   -h, --help            Show help.
@@ -144,7 +129,6 @@ export function printVersion() {
 export function helpCommandFromArgs(args) {
   const nonHelp = args.filter((arg) => !isHelpToken(arg));
   if (nonHelp[0] === 'graph' && nonHelp[1]) return `graph ${nonHelp[1]}`;
-  if (nonHelp[0] === 'trello' && nonHelp[1]) return `trello ${nonHelp[1]}`;
   if (nonHelp[0] === 'traceability' && nonHelp[1]) return `traceability ${nonHelp[1]}`;
   if (nonHelp[0] === 'config' && nonHelp[1] === 'init') return 'config init';
   return nonHelp[0] ?? 'root';

package/src/commands/config.mjs

@@ -43,7 +43,6 @@ function formatConfigOutput(payload) {
   lines.push(`- load pinned bodies: ${(payload.config.load?.pinnedBodies ?? []).join(', ') || 'none'}`);
   lines.push(`- load documentation summary exclude: ${(payload.config.load?.documentationSummary?.exclude ?? []).join(', ') || 'none'}`);
   lines.push(`- plan mode writable paths: ${(payload.config.planMode?.writablePaths ?? []).join(', ') || 'none'}`);
-  lines.push(`- trello sync paths: ${(payload.config.integrations?.trello?.syncPaths ?? []).join(', ') || 'none'}`);
   const lowSignal = payload.config.referenceExpansion?.fuzzy?.lowSignal ?? { terms: [], add: [], remove: [] };
   lines.push(`- fuzzy low-signal terms: ${(lowSignal.terms ?? []).join(', ') || 'none'} (add: ${(lowSignal.add ?? []).join(', ') || 'none'}; remove: ${(lowSignal.remove ?? []).join(', ') || 'none'})`);
   if (errors.length > 0) {

package/src/core.mjs

@@ -7,14 +7,13 @@ import { runQuery } from './commands/query.mjs';
 import { runResolve, runExpand } from './reference/resolve.mjs';
 import { runTraceability } from './commands/traceability.mjs';
 import { runGraph } from './commands/graph.mjs';
-import { runTrelloSync } from './trello/sync.mjs';
 
 export { CACHE_VERSION } from './index/constants.mjs';
 export { commandUsage, hasHelpToken, helpCommandFromArgs, isHelpToken, isVersionToken, parseCommon, printVersion, usage } from './cli/usage.mjs';
 export { rel } from './common/paths.mjs';
 export { extractAnchors, extractFirstHeading, extractLinks, headingToAnchor, isKebabCase, isNumberedSeriesFilename, isUpperSnakeMarkdown, removeCodeBlocks, suggestFilenameFromHeading } from './docs/markdown.mjs';
 export { extractDotdotgodTraceabilityBlocks, findTraceabilityLinksRegion, isLocalRelativeTraceabilityPath, renderCompactTraceabilityBlock, stripTraceabilityLinksRegion, syncTraceabilityLinksInContent, traceabilityExample, validateTraceabilityBlock, validateTraceabilityLinksRegion, validateTraceabilityPlacement } from './docs/traceability.mjs';
-export { DEFAULT_IMPACT_RANKING_POLICY, DEFAULT_INTEGRATIONS_POLICY, DEFAULT_LOAD_POLICY, DEFAULT_VALIDATION_POLICY, SEMANTIC_RELATIONS, cloneImpactRankingPolicy, cloneIntegrationsPolicy, cloneLoadPolicy, cloneReferenceExpansionPolicy, cloneValidationPolicy, defaultDotdotgodConfigData, defaultDotdotgodConfigText, defaultMemoryConfig, isMarkdownSizeExcluded, isSecretLikePathPattern, isValidPathPattern, matchPathPattern, memoryAreaForPath, memoryConfigSummary, normalizeLowSignalTerm, readMemoryConfig, requiresTraceability, resolveMemoryArea, trelloSyncPaths, validateMemoryConfigData } from './memory/config.mjs';
+export { DEFAULT_IMPACT_RANKING_POLICY, DEFAULT_LOAD_POLICY, DEFAULT_VALIDATION_POLICY, SEMANTIC_RELATIONS, cloneImpactRankingPolicy, cloneLoadPolicy, cloneReferenceExpansionPolicy, cloneValidationPolicy, defaultDotdotgodConfigData, defaultDotdotgodConfigText, defaultMemoryConfig, isMarkdownSizeExcluded, isSecretLikePathPattern, isValidPathPattern, matchPathPattern, memoryAreaForPath, memoryConfigSummary, normalizeLowSignalTerm, readMemoryConfig, requiresTraceability, resolveMemoryArea, validateMemoryConfigData } from './memory/config.mjs';
 export { buildCommunities, relationWeight } from './graph/communities.mjs';
 export { addEdge, addNode, compactGraph, expandGraph, graphStats, jsonSize, shardFile, writeJson } from './graph/store.mjs';
 export { cacheFile, collectIndexFiles, fingerprint, shouldIndexPath } from './index/files.mjs';
@@ -34,13 +33,6 @@ export { extractBracketReferences, extractFuzzyReferences, normalizeReferenceAli
 export { resolveReferenceCandidates, runResolve, runExpand } from './reference/resolve.mjs';
 export { parseTraceabilityOptions, runTraceability } from './commands/traceability.mjs';
 export { parseGraphOptions, runGraph } from './commands/graph.mjs';
-export { planTrelloDryRun, runTrelloSync } from './trello/sync.mjs';
-export { parseTrelloMetadata, extractTrelloShortLink } from './trello/metadata.mjs';
-export { normalizeGitHubRemote, resolveGitHubFileUrl, resolveGitHubRepositoryIdentity } from './trello/github-url.mjs';
-export { buildLinkedDocsData, summarizeTraceability } from './trello/summary.mjs';
-export { formatTrelloDryRunReport, formatTrelloWriteReport } from './trello/report.mjs';
-export { createTrelloClient, resolveTrelloCredentials } from './trello/client.mjs';
-export { customFieldTextValue, DEFAULT_DOTDOTGOD_CUSTOM_FIELD_NAME, dotdotgodCustomFieldName, mergeLinkedDocsCustomFieldValue, parseLinkedDocsCustomFieldPayload, serializeLinkedDocsCustomFieldPayload } from './trello/custom-fields.mjs';
 
 export async function runCli(argv = process.argv.slice(2)) {
   const [command = 'help', ...args] = argv;
@@ -58,13 +50,5 @@ export async function runCli(argv = process.argv.slice(2)) {
   else if (command === 'expand') runExpand(args);
   else if (command === 'traceability') runTraceability(args);
   else if (command === 'graph') await runGraph(args);
-  else if (command === 'trello') {
-    const result = await Promise.resolve(runTrelloSync(args));
-    if (result.stdout) process.stdout.write(result.stdout);
-    if (result.stderr) {
-      console.error(result.stderr);
-      console.error(commandUsage('trello'));
-    }
-    process.exit(result.exitCode);
-  } else usage(`Unknown command: ${command}`);
+  else usage(`Unknown command: ${command}`);
 }

package/src/memory/config.mjs

@@ -21,9 +21,6 @@ export const DEFAULT_VALIDATION_POLICY = {
     },
   },
 };
-export const DEFAULT_INTEGRATIONS_POLICY = {
-  trello: { syncPaths: [] },
-};
 export const DEFAULT_LOAD_POLICY = {
   pinnedPaths: [],
   pinnedBodies: [],
@@ -177,10 +174,6 @@ function normalizeImpactRankingPolicy(raw) {
   return cloneImpactRankingPolicy({ ...preset, ...raw, preset: presetName, weights: { ...(preset.weights ?? {}), ...(raw?.weights ?? {}) }, ppr: { ...(preset.ppr ?? {}), ...(raw?.ppr ?? {}) }, semantic: { ...(preset.semantic ?? {}), ...(raw?.semantic ?? {}) } });
 }
 
-export function cloneIntegrationsPolicy(policy = DEFAULT_INTEGRATIONS_POLICY) {
-  return { trello: { syncPaths: [...(policy.trello?.syncPaths ?? [])] } };
-}
-
 export function cloneLoadPolicy(policy = DEFAULT_LOAD_POLICY) {
   return {
     pinnedPaths: [...(policy.pinnedPaths ?? [])],
@@ -196,7 +189,7 @@ export function clonePlanModePolicy(policy = DEFAULT_PLAN_MODE_POLICY) {
 }
 
 export function defaultMemoryConfig() {
-  return { source: 'default', areas: DEFAULT_MEMORY_AREAS.map(cloneArea), traceability: cloneTraceabilityPolicy(), validation: cloneValidationPolicy(), impactRanking: cloneImpactRankingPolicy(), referenceExpansion: cloneReferenceExpansionPolicy(), integrations: cloneIntegrationsPolicy(), load: cloneLoadPolicy(), planMode: clonePlanModePolicy() };
+  return { source: 'default', areas: DEFAULT_MEMORY_AREAS.map(cloneArea), traceability: cloneTraceabilityPolicy(), validation: cloneValidationPolicy(), impactRanking: cloneImpactRankingPolicy(), referenceExpansion: cloneReferenceExpansionPolicy(), load: cloneLoadPolicy(), planMode: clonePlanModePolicy() };
 }
 
 export function normalizePathPattern(value = '') {
@@ -264,12 +257,6 @@ function normalizeValidationPolicy(raw) {
   });
 }
 
-function normalizeIntegrationsPolicy(raw) {
-  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return cloneIntegrationsPolicy();
-  const syncPaths = Array.isArray(raw.trello?.syncPaths) ? raw.trello.syncPaths.map(normalizePathPattern) : [];
-  return cloneIntegrationsPolicy({ trello: { syncPaths: [...new Set(syncPaths)] } });
-}
-
 export function isSecretLikePathPattern(value = '') {
   const normalized = normalizePathPattern(value);
   return /(^|\/)(\.env|\.npmrc|\.pypirc|id_rsa|id_dsa|id_ed25519|credentials?|secrets?)(\.|\/|$)/i.test(normalized);
@@ -297,10 +284,6 @@ function normalizeLoadPolicy(raw) {
   });
 }
 
-export function trelloSyncPaths(config = defaultMemoryConfig()) {
-  return [...new Set(['docs/trello/**', ...((config.integrations ?? DEFAULT_INTEGRATIONS_POLICY).trello?.syncPaths ?? [])])];
-}
-
 export function isMarkdownSizeExcluded(path = '', config = defaultMemoryConfig()) {
   const policy = config.validation ?? DEFAULT_VALIDATION_POLICY;
   return (policy.markdown?.exclude ?? []).some((pattern) => matchPathPattern(path, pattern));
@@ -383,23 +366,6 @@ export function validateMemoryConfigData(data, root = '.', file = 'dotdotgod.con
       }
     }
   }
-  const integrations = data.integrations;
-  if (integrations !== undefined) {
-    if (!integrations || typeof integrations !== 'object' || Array.isArray(integrations)) {
-      add('INTEGRATIONS_CONFIG_INVALID', 'integrations', 'Expected an object.');
-    } else if (integrations.trello !== undefined) {
-      const trello = integrations.trello;
-      if (!trello || typeof trello !== 'object' || Array.isArray(trello)) {
-        add('INTEGRATIONS_TRELLO_CONFIG_INVALID', 'integrations.trello', 'Expected an object.');
-      } else if (trello.syncPaths !== undefined) {
-        if (!Array.isArray(trello.syncPaths)) add('INTEGRATIONS_TRELLO_INVALID_SYNC_PATHS', 'integrations.trello.syncPaths', 'Expected an array of path strings.');
-        else {
-          if (trello.syncPaths.some((value) => !isValidPathPattern(value) || (typeof value === 'string' && value.trim().startsWith('/')))) add('INTEGRATIONS_TRELLO_INVALID_SYNC_PATHS', 'integrations.trello.syncPaths', 'Expected repository-relative path strings using exact paths, /** subtree patterns, or **/suffix patterns.');
-          if (trello.syncPaths.some((value) => typeof value === 'string' && isSecretLikePathPattern(value))) add('INTEGRATIONS_TRELLO_SECRET_SYNC_PATH', 'integrations.trello.syncPaths', 'Sync paths must not target secrets, credentials, environment files, or private keys.');
-        }
-      }
-    }
-  }
   const load = data.load;
   if (load !== undefined) {
     if (!load || typeof load !== 'object' || Array.isArray(load)) {
@@ -544,10 +510,9 @@ export function readMemoryConfig(root = '.') {
     const validation = data.validation === undefined ? cloneValidationPolicy() : normalizeValidationPolicy(data.validation);
     const impactRanking = normalizeImpactRankingPolicy(data.impactRanking);
     const referenceExpansion = normalizeReferenceExpansionPolicy(data.referenceExpansion);
-    const integrations = normalizeIntegrationsPolicy(data.integrations);
     const load = normalizeLoadPolicy(data.load);
     const planMode = normalizePlanModePolicy(data.planMode);
-    return configuredAreas.length > 0 ? { source: MEMORY_CONFIG_FILE, areas: configuredAreas, traceability, validation, impactRanking, referenceExpansion, integrations, load, planMode, errors: [] } : { ...defaultMemoryConfig(), traceability, validation, impactRanking, referenceExpansion, integrations, load, planMode, source: MEMORY_CONFIG_FILE, errors: [] };
+    return configuredAreas.length > 0 ? { source: MEMORY_CONFIG_FILE, areas: configuredAreas, traceability, validation, impactRanking, referenceExpansion, load, planMode, errors: [] } : { ...defaultMemoryConfig(), traceability, validation, impactRanking, referenceExpansion, load, planMode, source: MEMORY_CONFIG_FILE, errors: [] };
   } catch (error) {
     return { ...defaultMemoryConfig(), source: MEMORY_CONFIG_FILE, errors: [{ file: MEMORY_CONFIG_FILE, code: 'MEMORY_CONFIG_INVALID_JSON', message: `Invalid JSON: ${error instanceof Error ? error.message : String(error)}\nFix: repair ${MEMORY_CONFIG_FILE} so it is valid JSON, or remove it before regenerating the default config with \`dotdotgod config init <root>\`.` }] };
   }
@@ -577,7 +542,6 @@ export function defaultDotdotgodConfigData() {
     validation: cloneValidationPolicy(config.validation),
     impactRanking: cloneImpactRankingPolicy(config.impactRanking),
     referenceExpansion: { fuzzy: { lowSignal: { add: [], remove: [] } } },
-    integrations: cloneIntegrationsPolicy(config.integrations),
     load: cloneLoadPolicy(config.load),
     planMode: clonePlanModePolicy(config.planMode),
   };
@@ -605,7 +569,6 @@ export function memoryConfigSummary(config) {
     validation: cloneValidationPolicy(config.validation ?? DEFAULT_VALIDATION_POLICY),
     impactRanking: cloneImpactRankingPolicy(config.impactRanking ?? DEFAULT_IMPACT_RANKING_POLICY),
     referenceExpansion: cloneReferenceExpansionPolicy(config.referenceExpansion),
-    integrations: cloneIntegrationsPolicy(config.integrations),
     load: cloneLoadPolicy(config.load),
     planMode: clonePlanModePolicy(config.planMode),
   };

package/src/validate/run.mjs

@@ -61,9 +61,17 @@ export function runValidate(argv) {
   const maxChars = options.maxChars ?? validationPolicy.markdown.maxChars;
   const markdownSizePrompt = (path) => {
     const area = resolveMemoryArea(path, memoryConfig);
-    const areaText = area ? `${area.label ?? area.id} (${area.id})` : 'the matching documentation area';
-    const roleText = area?.role ?? 'the document role';
-    return `Split ${path} into focused documents by documentation area and role. Keep the current ${areaText} area semantics and ${roleText} role intact, move role-specific detail into smaller UPPER_SNAKE_CASE markdown files, and update the nearest README.md index with each new file's purpose.`;
+    const clarify = area?.clarify;
+    const guidance = [
+      clarify?.documentType ? `document type: ${clarify.documentType}` : null,
+      clarify?.audience?.length ? `audience: ${clarify.audience.join(', ')}` : null,
+      clarify?.clarityGoal ? `clarity goal: ${clarify.clarityGoal}` : null,
+      clarify?.editRules?.length ? `edit rules: ${clarify.editRules.join('; ')}` : null,
+    ].filter(Boolean);
+    const evidence = guidance.length > 0
+      ? ` Follow this resolved clarification guidance: ${guidance.join('; ')}.`
+      : ' Preserve the document\'s current purpose and established meaning, using its content, links, and nearest README.md as evidence.';
+    return `Split ${path} into focused UPPER_SNAKE_CASE markdown files.${evidence} Keep each file focused and update the nearest README.md index with every new file's purpose.`;
   };
   for (const error of memoryConfig.errors ?? []) errors.push(error);
   const FILENAME_QUALITY_AREAS = new Set(
@@ -73,18 +81,14 @@ export function runValidate(argv) {
       .map(p => { const m = p.match(/^docs\/([^/*]+)\/\*\*$/); return m ? m[1] : null; })
       .filter(Boolean)
   );
+  const filenameQualityScope = [...FILENAME_QUALITY_AREAS].sort().map(area => `docs/${area}`).join(', ') || 'configured shared documentation areas';
   const FILENAME_QUALITY_PROMPT =
-    'Background: Filenames and paths are LLM/agent context signals used for impact ranking, search, and retrieval. ' +
-    'Abstract or sequentially numbered filenames carry low information signal.\n' +
-    'Naming principles:\n' +
-    '1. Filenames in docs/spec, docs/arch, docs/test should be meaning-based wherever possible.\n' +
-    '2. The filename alone should let you infer the primary subject: endpoint, screen, policy, state, or response type.\n' +
-    '3. When splitting documents, derive names from headings, API paths, or domain terms rather than sequence numbers or abstract words.\n' +
-    'Avoid - numbered splits: API_1.md, API_2.md, API_3_1_*.md, 01_*.md, *_01.md\n' +
-    'Avoid - overly abstract: COMMON.md, OVERVIEW.md, DETAILS.md, NOTES.md, MISC.md, PART_1.md, SECTION_1.md\n' +
-    'Acceptable exceptions: README.md (directory index), files with clear HTTP status code semantics (e.g. RESPONSE_200_OK.md), ' +
-    'files in the project validation.markdown.filename.allow allowlist.\n' +
-    'Good renames: API_1.md → BIZ_RESERVATIONS_SCHEDULE.md, COMMON.md → BIZ_AUTH_ERROR_CONVENTIONS.md, OVERVIEW.md → REGISTRATION_HANDOFF_SUMMARY.md';
+    'Filenames and paths are LLM/agent context signals used for impact ranking, search, and retrieval.\n' +
+    `Use meaning-based filenames in ${filenameQualityScope}. A filename should identify its primary endpoint, screen, policy, state, response type, or domain subject. ` +
+    'Derive split-document names from headings, API paths, and established domain terms.\n' +
+    'Rename numbered or abstract series such as API_1.md, PART_1.md, COMMON.md, or DETAILS.md to subject-specific names. ' +
+    'Examples: API_1.md → BIZ_RESERVATIONS_SCHEDULE.md; COMMON.md → BIZ_AUTH_ERROR_CONVENTIONS.md.\n' +
+    'README.md directory indexes, clear HTTP-status filenames such as RESPONSE_200_OK.md, and configured filename allowlist entries remain valid.';
   walk(docs);
   const dirSiblingMap = new Map();
   for (const f of markdownFiles) {

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 ?? [])],
-  };
-}
-

package/src/trello/sync.mjs

@@ -1,205 +0,0 @@
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { rel } from '../common/paths.mjs';
-import { matchPathPattern, readMemoryConfig, trelloSyncPaths } from '../memory/config.mjs';
-import { parseTrelloMetadata } from './metadata.mjs';
-import { resolveGitHubFileUrl } from './github-url.mjs';
-import { buildLinkedDocsData, summarizeTraceability } from './summary.mjs';
-import { formatTrelloDryRunReport, formatTrelloWriteReport } from './report.mjs';
-import { createTrelloClient, resolveTrelloCredentials } from './client.mjs';
-import { customFieldTextValue, dotdotgodCustomFieldName, mergeLinkedDocsCustomFieldValue } from './custom-fields.mjs';
-
-function shouldSkipDir(path) {
-  return path === '.git' || path === 'node_modules' || path === '.dotdotgod';
-}
-
-function walkMarkdown(root, dir = root, files = []) {
-  if (!existsSync(dir)) return files;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (entry.isDirectory()) {
-      if (!shouldSkipDir(entry.name)) walkMarkdown(root, join(dir, entry.name), files);
-    } else if (entry.isFile() && entry.name.endsWith('.md')) files.push(join(dir, entry.name));
-  }
-  return files;
-}
-
-function matchedByPatterns(path, patterns) {
-  return patterns.some((pattern) => matchPathPattern(path, pattern));
-}
-
-function fileReport({ file, trelloUrl = '', shortLink = '', githubUrl = '', repositoryKey = '', syncStatus = 'blocked', traceability = { state: 'not_required', details: [] }, warnings = [], errors = [], linkedDocsData = null }) {
-  return { file, trelloUrl, shortLink, githubUrl, repositoryKey, plannedAttachmentAction: errors.length > 0 ? 'blocked' : 'add-or-verify', plannedCustomFieldAction: errors.length > 0 ? 'blocked' : 'sync-linked-docs', syncStatus, traceability, linkedDocsData, warnings, errors };
-}
-
-function actionableError(error, fallback = 'Trello API request failed. Fix: check credentials, card access, and Trello response details, then retry.') {
-  if (error && typeof error === 'object' && error.code && error.message) return error;
-  return { code: 'TRELLO_API_FAILED', message: error?.message ? `${error.message} Fix: check credentials, card access, and Trello response details, then retry.` : fallback };
-}
-
-function duplicateErrors(files) {
-  const byShortLink = new Map();
-  for (const file of files.filter((item) => item.syncStatus === 'planned')) {
-    byShortLink.set(file.shortLink, [...(byShortLink.get(file.shortLink) ?? []), file]);
-  }
-  const duplicateShortLinks = new Set([...byShortLink.entries()].filter(([, group]) => group.length > 1).map(([shortLink]) => shortLink));
-  for (const shortLink of duplicateShortLinks) {
-    const paths = byShortLink.get(shortLink).map((file) => file.file).join(', ');
-    for (const file of byShortLink.get(shortLink)) {
-      file.errors.push({ code: 'TRELLO_DUPLICATE_CARD', message: `Multiple markdown files point to Trello card ${shortLink}: ${paths}. Fix: keep only one markdown file linked to this Trello card, then retry sync.` });
-      file.syncStatus = 'conflict';
-      file.plannedAttachmentAction = 'conflict';
-      file.plannedCustomFieldAction = 'conflict';
-    }
-  }
-  return duplicateShortLinks.size;
-}
-
-export function planTrelloDryRun(rootInput = '.', options = {}) {
-  const root = resolve(rootInput);
-  const config = options.config ?? readMemoryConfig(root);
-  const scanPaths = trelloSyncPaths(config);
-  const reportWarnings = [];
-  const reportErrors = [];
-  if (config.errors?.length) reportErrors.push(...config.errors.map((error) => ({ code: error.code, message: error.message })));
-  const allFiles = walkMarkdown(root).map((file) => ({ abs: file, rel: rel(root, file) })).filter((file) => matchedByPatterns(file.rel, scanPaths)).sort((a, b) => a.rel.localeCompare(b.rel));
-  const files = [];
-  if (allFiles.length === 0) reportWarnings.push({ code: 'TRELLO_NO_MATCHING_DOCS', message: 'No markdown files matched Trello sync paths.' });
-  for (const item of allFiles) {
-    const content = readFileSync(item.abs, 'utf8');
-    const metadata = parseTrelloMetadata(content);
-    const warnings = [...metadata.warnings];
-    const errors = [...metadata.errors];
-    let githubUrl = '';
-    let repositoryKey = '';
-    if (errors.length === 0) {
-      const resolved = resolveGitHubFileUrl({ root, file: item.rel, env: options.env ?? process.env, mode: options.mode ?? 'dry-run', ...(options.github ?? {}) });
-      warnings.push(...resolved.warnings);
-      if (resolved.ok) {
-        githubUrl = resolved.url;
-        repositoryKey = resolved.repositoryKey;
-      } else errors.push(...resolved.errors);
-    }
-    const traceability = summarizeTraceability({ content, root, file: item.rel, config });
-    if (traceability.errors.length > 0) errors.push(...traceability.errors);
-    const syncStatus = errors.length > 0 ? 'blocked' : 'planned';
-    const linkedDocsData = buildLinkedDocsData({ file: item.rel, content, githubUrl, trelloUrl: metadata.trelloUrl, syncStatus, traceability, repositoryKey });
-    files.push(fileReport({ file: item.rel, trelloUrl: metadata.trelloUrl, shortLink: metadata.shortLink, githubUrl, repositoryKey, syncStatus, traceability: { state: traceability.state, details: traceability.details }, warnings, errors, linkedDocsData }));
-  }
-  duplicateErrors(files);
-  const warningCount = reportWarnings.length + files.reduce((sum, file) => sum + file.warnings.length, 0);
-  const errorCount = reportErrors.length + files.reduce((sum, file) => sum + file.errors.length, 0);
-  const report = { ok: errorCount === 0, command: 'trello sync', mode: 'dry-run', root, scanPaths, totals: { matchedFiles: files.length, plannedUpdates: files.filter((file) => file.syncStatus === 'planned').length, warnings: warningCount, errors: errorCount }, warnings: reportWarnings, errors: reportErrors, files };
-  return { report, exitCode: errorCount > 0 ? 1 : 0 };
-}
-
-function trustedCiWriteContext(env = process.env) {
-  const defaultBranch = env.GITHUB_DEFAULT_BRANCH || env.DOTDOTGOD_DEFAULT_BRANCH || env.GITHUB_EVENT_REPOSITORY_DEFAULT_BRANCH;
-  return env.GITHUB_ACTIONS === 'true' && env.GITHUB_EVENT_NAME === 'push' && Boolean(defaultBranch) && env.GITHUB_REF === `refs/heads/${defaultBranch}`;
-}
-
-async function runTrelloWrite(rootInput = '.', options = {}) {
-  const env = options.env ?? process.env;
-  const { report: dryRunReport } = planTrelloDryRun(rootInput, { ...options, mode: 'write', env });
-  const report = { ...dryRunReport, mode: 'write', customFieldName: dotdotgodCustomFieldName({ env, name: options.customFieldName }), files: dryRunReport.files.map((file) => ({ ...file, attachment: { status: 'not-run' }, customField: { status: 'not-run' }, finalStatus: file.syncStatus === 'blocked' ? 'blocked' : 'pending' })) };
-
-  if (!trustedCiWriteContext(env)) {
-    return { exitCode: 2, stderr: 'Trello write mode is only allowed from the trusted GitHub Actions default-branch push workflow. Fix: run dotdotgod trello sync <root> --dry-run locally or merge docs to the default branch so the workflow can write to Trello.', report };
-  }
-
-  if (report.files.length === 0) {
-    report.totals = { matchedFiles: 0, written: 0, unchanged: 0, blocked: 0, conflict: 0, apiFailed: 0, warnings: report.totals.warnings, errors: report.totals.errors };
-    report.ok = report.totals.errors === 0;
-    return { report, exitCode: report.ok ? 0 : 1 };
-  }
-
-  const credentials = options.credentials ?? resolveTrelloCredentials({ env });
-  if (!credentials.ok) return { exitCode: 2, stderr: credentials.error.message, report };
-
-  const client = options.trelloClient ?? createTrelloClient({ credentials: credentials.credentials, fetchImpl: options.fetch, baseUrl: options.trelloBaseUrl });
-
-  for (const file of report.files) {
-    if (file.syncStatus === 'blocked') {
-      file.finalStatus = 'blocked';
-      continue;
-    }
-    if (file.syncStatus === 'conflict') {
-      file.finalStatus = 'conflict';
-      continue;
-    }
-    let step = 'card';
-    try {
-      const card = await client.getCard(file.shortLink);
-      step = 'attachments';
-      const attachments = await client.listAttachments(file.shortLink);
-      if (attachments.some((attachment) => attachment?.url === file.githubUrl)) {
-        file.attachment.status = 'unchanged';
-      } else {
-        step = 'attachment-create';
-        await client.createAttachment(file.shortLink, file.githubUrl);
-        file.attachment.status = 'written';
-      }
-      step = 'custom-field-definition';
-      const fields = await client.listCustomFields(card.idBoard);
-      let field = fields.find((item) => item?.name === report.customFieldName && item?.type === 'text');
-      if (!field) field = await client.createCustomField(card.idBoard, { name: report.customFieldName, type: 'text' });
-      if (!field?.id) throw { code: 'TRELLO_CUSTOM_FIELD_INVALID', message: 'Trello custom field creation returned no field id. Fix: check board custom field permissions and retry.' };
-      const merged = mergeLinkedDocsCustomFieldValue(customFieldTextValue(card, field.id), file.linkedDocsData);
-      if (!merged.ok) {
-        file.customField.status = 'conflict';
-        file.errors.push(merged.error);
-        file.finalStatus = 'conflict';
-        continue;
-      }
-      file.customField.action = merged.action;
-      file.customField.preservedRepositoryEntries = merged.preservedRepositoryEntries ?? 0;
-      file.customField.name = report.customFieldName;
-      if (merged.status === 'unchanged') {
-        file.customField.status = 'unchanged';
-      } else {
-        step = 'custom-field-update';
-        await client.updateCardCustomFieldText(card.id, field.id, merged.text);
-        file.customField.status = 'written';
-      }
-      file.finalStatus = file.attachment.status === 'written' || file.customField.status === 'written' ? 'written' : 'unchanged';
-    } catch (error) {
-      const normalized = actionableError(error);
-      if (step === 'attachment-create') file.attachment.status = 'failed';
-      else if (step.startsWith('custom-field')) file.customField.status = 'failed';
-      file.finalStatus = 'api-failed';
-      file.errors.push(normalized);
-    }
-  }
-
-  const counts = { written: 0, unchanged: 0, blocked: 0, conflict: 0, apiFailed: 0 };
-  for (const file of report.files) {
-    if (file.finalStatus === 'written') counts.written += 1;
-    else if (file.finalStatus === 'unchanged') counts.unchanged += 1;
-    else if (file.finalStatus === 'blocked') counts.blocked += 1;
-    else if (file.finalStatus === 'conflict') counts.conflict += 1;
-    else if (file.finalStatus === 'api-failed') counts.apiFailed += 1;
-  }
-  const warningCount = report.warnings.length + report.files.reduce((sum, file) => sum + file.warnings.length, 0);
-  const errorCount = report.errors.length + report.files.reduce((sum, file) => sum + file.errors.length, 0);
-  report.totals = { matchedFiles: report.files.length, ...counts, warnings: warningCount, errors: errorCount };
-  report.ok = counts.blocked === 0 && counts.conflict === 0 && counts.apiFailed === 0 && errorCount === 0;
-  return { report, exitCode: report.ok ? 0 : 1 };
-}
-
-export function runTrelloSync(argv = [], options = {}) {
-  if (argv[0] !== 'sync') return { exitCode: 2, stderr: `Unknown Trello command: ${argv[0] ?? ''}`.trim() };
-  const args = argv.slice(1);
-  let root = '.';
-  let dryRun = false;
-  for (const arg of args) {
-    if (arg === '--dry-run') dryRun = true;
-    else if (arg.startsWith('-')) return { exitCode: 2, stderr: `Unknown option: ${arg}` };
-    else root = arg;
-  }
-  const resolvedRoot = resolve(root);
-  if (!existsSync(resolvedRoot) || !statSync(resolvedRoot).isDirectory()) return { exitCode: 2, stderr: `Project root not found: ${resolvedRoot}` };
-  if (dryRun) {
-    const { report, exitCode } = planTrelloDryRun(resolvedRoot, options);
-    return { exitCode, stdout: formatTrelloDryRunReport(report), report };
-  }
-  return runTrelloWrite(resolvedRoot, options).then((result) => ({ ...result, stdout: result.stdout ?? (result.report ? formatTrelloWriteReport(result.report) : '') }));
-}