Function buildBlocks

core/memory/blocks.js:103–213

(projectRoot, options = {})

}

function buildBlocks(projectRoot, options = {}) {
  const campaignPath = '.planning/campaigns/citadel-competitor-gap-assessment.md';
  const campaignText = readText(projectRoot, campaignPath);
  const patternText = readText(projectRoot, '.planning/research/patterns.md');
  const insightText = readText(projectRoot, '.planning/research/external-insights-brief.md');
  const packageJson = readText(projectRoot, 'package.json');
  const decisions = extractDecisionLog(campaignText);
  const patterns = extractPatternLines(patternText || insightText, 10);

  const fleetOutputs = listFiles(path.join(projectRoot, '.planning', 'fleet'), (file) => /\.(md|json|jsonl)$/.test(file), 10)
    .map((file) => source(projectRoot, rel(projectRoot, file), 'fleet output or session evidence'));
  const postmortems = listFiles(path.join(projectRoot, '.planning', 'postmortems'), (file) => file.endsWith('.md'), 10)
    .map((file) => source(projectRoot, rel(projectRoot, file), 'postmortem evidence'));

  return [
    block(
      'memory-project-rules',
      'project-rules',
      ['project', 'harness', 'skills', 'hooks'],
      availableSources(projectRoot, [
        source(projectRoot, 'AGENTS.md', 'repository operating rules'),
        source(projectRoot, 'docs/CONSTITUTION.md', 'harness rule hierarchy'),
        source(projectRoot, 'docs/SKILLS.md', 'skill authoring and handoff contract'),
      ]),
      [
        '- Treat this repository as the Citadel harness; skills, agents, hooks, and state files are first-class product surfaces.',
        '- Keep changes scoped to harness conventions: skills in `skills/`, agents in `agents/`, hooks in `hooks_src/`, and campaign state in `.planning/`.',
        '- Every completed task must leave a compact HANDOFF and enough verification evidence for another session to resume.',
      ].join('\n'),
      'high',
      options
    ),
    block(
      'memory-architecture-decisions',
      'architecture-decisions',
      ['architecture', 'codex', 'fleet', 'worktree', 'telemetry'],
      availableSources(projectRoot, [
        source(projectRoot, 'docs/ARCHITECTURE.md', 'current harness architecture'),
        source(projectRoot, 'docs/CODEX_NATIVE_INTEGRATIONS.md', 'Codex-native integration decisions'),
        source(projectRoot, 'docs/FLEET.md', 'fleet coordination design'),
        source(projectRoot, 'docs/worktree-isolation.md', 'worktree readiness design'),
        source(projectRoot, campaignPath, 'competitor-gap implementation decisions'),
      ]),
      [
        '- Citadel owns durable campaign memory, discovery relay, scope claims, policy, and evidence even when Codex supplies native execution primitives.',
        '- Fleet work is dependency-aware: ready work, blocked work, readiness-blocked work, and merge-order blockers are separate operator states.',
        '- Telemetry and artifact records now carry lineage IDs plus `_hash`; optional HMAC signing upgrades integrity without breaking old legacy records.',
        ...decisions.slice(-6),
      ].join('\n'),
      'high',
      options
    ),
    block(
      'memory-verification-recipes',
      'verification-recipes',
      ['verification', 'tests', 'hooks', 'skills', 'telemetry'],
      availableSources(projectRoot, [
        source(projectRoot, 'AGENTS.md', 'required verification table'),