Summary
Allow deployments to configure which files must be read after compaction, instead of hardcoding WORKFLOW_AUTO.md in all environments.
Problem to solve
Current post-compaction audit warns if WORKFLOW_AUTO.md is not read. Many workspaces do not use that file, so operators get noisy/false-positive warnings after compaction and end up creating placeholder files only to satisfy audit.
Proposed solution
Add configurable settings for post-compaction audit required reads.
Proposed behavior:
- hooks.postCompactionAudit.enabled?: boolean
- hooks.postCompactionAudit.requiredReads?: string[]
If not configured, keep current defaults for backward compatibility.
Audit call should use resolved config instead of only hardcoded defaults.
Alternatives considered
Alternatives considered:
- Keep creating WORKFLOW_AUTO.md placeholder in every workspace (works but not a root fix)
- Local dist patch (fragile; breaks on update)
- Disable audit entirely (loses useful checks)
Impact
Affected: operators using custom startup protocols without WORKFLOW_AUTO.md
Severity: medium (persistent warning noise)
Frequency: every compaction cycle
Consequence: reduced alert trust + extra manual/no-op file management
Evidence/examples
Observed in bundled runtime code:
- DEFAULT_REQUIRED_READS includes "WORKFLOW_AUTO.md"
- auditPostCompactionReads is called with process.cwd and default required reads
Representative snippet:
const DEFAULT_REQUIRED_READS = ["WORKFLOW_AUTO.md", /memory/\d{4}-\d{2}-\d{2}.md/];
Additional information
No response
Summary
Allow deployments to configure which files must be read after compaction, instead of hardcoding WORKFLOW_AUTO.md in all environments.
Problem to solve
Current post-compaction audit warns if WORKFLOW_AUTO.md is not read. Many workspaces do not use that file, so operators get noisy/false-positive warnings after compaction and end up creating placeholder files only to satisfy audit.
Proposed solution
Add configurable settings for post-compaction audit required reads.
Proposed behavior:
If not configured, keep current defaults for backward compatibility.
Audit call should use resolved config instead of only hardcoded defaults.
Alternatives considered
Alternatives considered:
Impact
Affected: operators using custom startup protocols without WORKFLOW_AUTO.md
Severity: medium (persistent warning noise)
Frequency: every compaction cycle
Consequence: reduced alert trust + extra manual/no-op file management
Evidence/examples
Observed in bundled runtime code:
Representative snippet:
const DEFAULT_REQUIRED_READS = ["WORKFLOW_AUTO.md", /memory/\d{4}-\d{2}-\d{2}.md/];
Additional information
No response