T12 — Structured compaction template

{`
export const DEFAULT_COMPACTION_TEMPLATE = \`
Your task is to create a detailed summary of our conversation so far.
This summary will be used to restore context after compaction.

Please structure your summary with these EXACT 5 sections:

## Goal
One sentence: what is the user ultimately trying to accomplish?

## Instructions
Bullet list of rules, constraints, or preferences the user has stated.
Include coding style preferences, naming conventions, forbidden approaches.

## Discoveries
Technical facts learned about the codebase:
- File paths and their purpose
- Key functions/classes/symbols and what they do
- Patterns, conventions, or architecture decisions
- Environment details (language versions, dependencies, config)

## Accomplished
Chronological list of actions taken:
- Files created, edited, or deleted (with brief reason)
- Commands run and their outcome
- Decisions made and why

## Relevant files
List of files relevant to the current task:
- \`path/to/file.ts\` — one-line description of relevance

Keep each section focused and factual. Avoid narrative prose.
\`
`}

{`
export function getCompactionTemplate(
  plugins: Plugin[]
): string {
  // Plugin override: lấy template từ plugin đầu tiên có implement
  for (const plugin of plugins) {
    const customTemplate = plugin.compactionTemplate?.()
    if (customTemplate) return customTemplate
  }

  return DEFAULT_COMPACTION_TEMPLATE
}

// Trong T8 compact call:
const template  = getCompactionTemplate(session.plugins)
const summaryLLM = await llm.complete({
  messages: [...head, { role: 'user', content: template }],
})
`}

{`
const REQUIRED_SECTIONS = [
  '## Goal', '## Instructions', '## Discoveries',
  '## Accomplished', '## Relevant files',
]

function validateSummary(summary: string): boolean {
  return REQUIRED_SECTIONS.every(section =>
    summary.includes(section)
  )
}
// Nếu validateSummary = false → retry với reminder
// hoặc dùng summary partial (tốt hơn không có gì)
`}

{`
// ❌ Free-form — model tự quyết định cấu trúc
const template = "Please summarize our conversation so far."
// Kết quả điển hình:
// "We discussed a coding task where the user wanted to...
//  The assistant helped by... Overall, the key points were..."
// → Mất hoàn toàn: file paths, symbols, rules, accomplished actions
`}

{`
// ❌ Template không yêu cầu file list
const WEAK_TEMPLATE = \`
Summarize the conversation:
1. What is the goal?
2. What was accomplished?
\`
// Thiếu: file paths, rules, discoveries, relevant files
// Agent mới không biết relevant context về codebase
`}

{`
// compaction-template.ts — structured 5-section template

export const DEFAULT_COMPACTION_TEMPLATE = \`
Create a structured summary with EXACTLY these 5 sections:

## Goal
One sentence: the user's ultimate objective.

## Instructions
Bullet list of rules/constraints/preferences stated by user.

## Discoveries
Technical facts about the codebase:
- File paths and purpose
- Key symbols (functions, classes, types) and what they do
- Patterns, conventions, architectural decisions

## Accomplished
Chronological actions taken:
- Files created/edited/deleted (with reason)
- Commands run and outcomes
- Decisions made and rationale

## Relevant files
Files relevant to the current task:
- \`path/to/file\` — one-line relevance description

Be factual and concise. No narrative prose.
\`

const REQUIRED_SECTIONS = [
  '## Goal',
  '## Instructions',
  '## Discoveries',
  '## Accomplished',
  '## Relevant files',
] as const

export function validateSummary(summary: string): {
  valid: boolean
  missingSections: string[]
} {
  const missing = REQUIRED_SECTIONS.filter(s => !summary.includes(s))
  return { valid: missing.length === 0, missingSections: missing }
}

export function getTemplate(plugins: Plugin[]): string {
  for (const p of plugins) {
    const t = p.compactionTemplate?.()
    if (t) return t
  }
  return DEFAULT_COMPACTION_TEMPLATE
}
`}