Add release process documentation and open issues triage guide

[riatzukiza]

Summary

• Add comprehensive RELEASE_PROCESS.md with step-by-step release workflow
• Add open-issues-triage.md for systematic issue management
• Both documents support better project governance and maintenance

Details

This PR adds two important documentation files:

1. RELEASE_PROCESS.md - A detailed guide covering:

   • Release types and triggers
   • Pre-release validation checklist
   • Step-by-step release workflow
   • Post-release tasks
   • Emergency release procedures

2. open-issues-triage.md - A systematic approach for:

   • Issue classification and prioritization
   • Triage workflow and SLAs
   • Bug vs feature request handling
   • Documentation requirements
   • Escalation procedures

These documents establish clear processes for maintaining project quality and managing community contributions effectively.

[coderabbitai]

Caution

Review failed

Failed to post review comments

Summary by CodeRabbit

• New Features

  • Added conversation compaction to reduce token usage by summarizing conversation history
  • Implemented rolling log system for improved log persistence and management
  • Added session fork support for better context management
  • Enhanced cache metrics collection with performance reporting
  • Added new plugin configuration options for compaction control

• Improvements

  • Improved session management and cache eviction logic
  • Better error handling and logging across modules
  • Added cache migration support for legacy files

• Refactor

  • Standardized code formatting and quote usage across codebase
  • Reorganized imports and consolidated utilities for cleaner architecture

_{✏️ Tip: You can customize this high-level summary in your review settings.}

Walkthrough

This PR introduces end-to-end Codex conversation compaction, fork-aware session management, and a significant logger refactor to async rolling logs. It adds compaction utilities, integrates compaction workflows into request transformation and fetching, extends session managers with compaction APIs, refactors caching to use plugin-scoped prefixes, and adds configuration flags. Formatting and quote normalization applied across codebase.

Changes

Cohort / File(s)	Summary
Compaction Core lib/compaction/codex-compaction.ts, lib/compaction/compaction-executor.ts	New modules implementing conversation compaction with token estimation, command detection, serialization, and response finalization. Exports 8 new functions and 2 new interfaces for compaction workflow orchestration.
Request & Response Transformation lib/request/fetch-helpers.ts, lib/request/request-transformer.ts, lib/request/response-handler.ts	Integrates compaction into request transformation pipeline. Updates transformRequestForCodex and transformRequestBody signatures to handle compaction decisions and optional pluginConfig parameter; adds logic for conditional compaction prompt injection and result propagation.
Session & Cache Management lib/session/session-manager.ts, lib/session/response-recorder.ts, lib/cache/session-cache.ts	Adds fork-aware session keys and compaction summary/history methods to SessionManager; updates SessionCache.set type signature (quote style); collapses multi-line conditionals.
Logger Overhaul lib/logger.ts	Migrates from sync (node:fs) to async (node:fs/promises) file I/O; implements rolling buffered-log system with size/age rotation, environment-driven config, and new flushRollingLogsForTest export.
Configuration & Constants lib/config.ts, lib/constants.ts, lib/types.ts	Adds enableCodexCompaction, autoCompactMinMessages config options; adds SESSION_CONFIG, CONVERSATION_CONFIG, PERFORMANCE_CONFIG constants; extends ReasoningConfig with "xhigh" effort and SessionState with compaction fields.
Cache & Utility Refactoring lib/utils/cache-config.ts, lib/utils/clone.ts, lib/utils/input-item-utils.ts, lib/cache/cache-metrics.ts, lib/cache/cache-warming.ts, lib/cache/prompt-fingerprinting.ts	Introduces PLUGIN_PREFIX for scoped cache files; adds new clone utilities (deepClone, cloneInputItems); adds 10 new InputItem helper functions; updates CacheMetricsCollector with getMetrics() method and quote-style signature changes; minor formatting in warming/fingerprinting.
Prompts & Authentication lib/prompts/codex-compaction.ts, lib/prompts/codex.ts, lib/prompts/opencode-codex.ts, lib/auth/auth.ts, lib/auth/browser.ts, lib/auth/server.ts	Adds CODEX_COMPACTION_PROMPT and CODEX_SUMMARY_PREFIX constants; enhances codex.ts caching with multi-level etag/tag support and metadata; adds legacy cache migration and source URL tracking in opencode-codex.ts; auth files reordered imports and variable renames (type-only imports, _error).
Request Integration & Exports lib/request/codex-fetcher.ts	Wires pluginConfig into CodexFetcherDeps, conditionally invokes finalizeCompactionResponse, and passes handledResponse to session recording.
Test Suite Expansion test/codex-compaction.test.ts, test/compaction-executor.test.ts, test/request-transformer.test.ts, test/session-manager.test.ts, test/logger.test.ts, test/... (27+ test files)	Adds comprehensive tests for compaction helpers, executor, and session fork handling; updates request-transformer tests with 100+ new assertions; restructures logger tests for async/rolling-log behavior; normalizes quotes and imports across all test files.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Fetcher as CodexFetcher
    participant TxReq as Request<br/>Transformer
    participant Compact as Compaction<br/>Executor
    participant Session as SessionManager
    participant Logger as Logger

    User->>Fetcher: fetch request
    Fetcher->>TxReq: transformRequestForCodex
    TxReq->>TxReq: detect compaction command<br/>or check auto-compact
    alt Compaction enabled
        TxReq->>TxReq: build compaction prompt<br/>serialize conversation
        TxReq-->>Fetcher: compactionDecision + body
    else No compaction
        TxReq-->>Fetcher: body (no decision)
    end
    
    Fetcher->>Fetcher: fetch with transformed body
    Fetcher->>Fetcher: handleSuccessResponse
    
    alt compactionDecision exists
        Fetcher->>Compact: finalizeCompactionResponse
        Compact->>Compact: extract summary<br/>inject metadata
        Compact->>Session: applyCompactionSummary
        Compact-->>Fetcher: finalized response
    end
    
    Fetcher->>Session: recordSessionResponse
    Fetcher->>Logger: log request/response
    Logger->>Logger: append to rolling log<br/>manage rotation
    Fetcher-->>User: response

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Areas requiring extra attention:

• lib/logger.ts — Fundamental shift from synchronous to asynchronous file I/O; rolling log implementation with queue buffering, rotation thresholds, and environment-driven configuration. Verify edge cases: queue overflow behavior, concurrent write scenarios, and rotation file ordering under high load.
• lib/request/request-transformer.ts — Dense refactor (~500+ line changes) introducing compaction conditionals, multi-level prompt caching (etag/tag/fork keys), and model normalization branching (codex-max/xhigh support). Validate logic paths for CODEX_MODE with/without compaction, prompt cache key derivation consistency, and bridging logic preservation.
• lib/session/session-manager.ts — Fork-aware key derivation and new compaction APIs (applyCompactionSummary, applyCompactedHistory). Confirm fork ID extraction, session key uniqueness under forking, and compaction summary persistence across requests.
• lib/compaction/* — Entire new module; validate token approximation heuristic, conversation truncation logic (character limits), and command detection robustness across message formats.
• Cache migration in lib/prompts/opencode-codex.ts and lib/utils/cache-config.ts — Legacy file detection and migration; verify path handling, no data loss, and conflict resolution when legacy caches coexist.

Possibly related issues

• Feature: Codex-style conversation compaction and auto-compaction in plugin #5 — PR fully implements plugin-level codex-style conversation compaction with end-to-end workflow (command detection, serialization, finalization), directly addressing compaction feature request.
• SessionManager: align fork identifier with prompt cache fork hints #23 — PR extends fork-aware session key derivation in SessionManager and adds extractForkIdentifier logic that aligns with prompt-cache key handling for parent conversation ID hints.

Possibly related PRs

• fix: implement cache isolation to resolve OAuth plugin conflicts (Issue #25) #28 — Shares cache-config refactoring: both add PLUGIN_PREFIX and rename cache files (lib/utils/cache-config.ts, lib/prompts/opencode-codex.ts).
• Improve Codex branding and prompt fetch resilience #30 — Shares PLUGIN_NAME rename to "openhax/codex" and related message prefix updates across logger and prompt fetching.
• Device/stealth #20 — Overlaps compaction module design; both introduce lib/compaction/* and integrate into request-transformer, fetch-helpers, session-manager, and types.

Poem

🗜️ Conversations compress, fork-aware paths blend,
Logs roll asynchronously as transformations transcend.
Commands detect compaction, summaries save the day—
The plugin learns to remember the concise way. ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 43.97% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title accurately describes the main changes: adding documentation for release process and issues triage.
Description check	✅ Passed	The PR description is directly related to the changeset, providing clear details about the two documentation files being added and their purposes.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch docs/release-process-and-issues-triage

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}