Function loadTrellisContext

src/context/trellis.ts:108–164

(cwd: string)

 * no `.trellis/` directory (the common case for non-Trellis projects).
 */
export async function loadTrellisContext(cwd: string): Promise<TrellisContext | null> {
  const rootDir = await findTrellisRoot(cwd);
  if (!rootDir) return null;
  const base = path.join(rootDir, '.trellis');

  const [spec, tasks, journalsAll] = await Promise.all([
    readMarkdownDir(path.join(base, 'spec')),
    readMarkdownDir(path.join(base, 'tasks')),
    readMarkdownDir(path.join(base, 'workspace')),
  ]);

  // Specs: alphabetical (stable). Tasks: alphabetical. Journals: newest first, capped.
  spec.sort((a, b) => a.name.localeCompare(b.name));
  tasks.sort((a, b) => a.name.localeCompare(b.name));
  const journals = journalsAll
    .sort((a, b) => b.mtimeMs - a.mtimeMs)
    .slice(0, MAX_JOURNAL_FILES);

  if (spec.length === 0 && tasks.length === 0 && journals.length === 0) {
    return null; // .trellis exists but is empty — nothing to inject
  }

  const sections: string[] = [];
  sections.push(
    `## Trellis project harness\n` +
    `This project uses Trellis (.trellis/). Treat the spec below as binding ` +
    `conventions, the tasks as the current work and its status, and the journals ` +
    `as what happened in prior sessions. Follow the spec; continue the tasks; do ` +
    `not re-derive decisions already recorded in the journals. When you finish a ` +
    `unit of work or context fills up, update the relevant task status and append ` +
    `a short journal entry under .trellis/workspace/.`,
  );

  if (spec.length > 0) {
    sections.push(`### Conventions (.trellis/spec/)\n${packFiles(spec, MAX_SPEC_BYTES)}`);
  }
  if (tasks.length > 0) {
    sections.push(`### Tasks (.trellis/tasks/)\n${packFiles(tasks, MAX_TASK_BYTES)}`);
  }
  if (journals.length > 0) {
    sections.push(
      `### Recent journals (.trellis/workspace/, newest first)\n` +
      packFiles(journals, MAX_JOURNAL_BYTES),
    );
  }

  const specBlock = spec.length > 0
    ? `## Trellis conventions (.trellis/spec/) — binding\n${packFiles(spec, MAX_SPEC_BYTES)}`
    : null;

  return {
    block: sections.join('\n\n'),
    specBlock,
    rootDir,
    counts: { specFiles: spec.length, taskFiles: tasks.length, journalFiles: journals.length },
  };
}