create clear subcommand

[divanvisagie]

Current Issue

The current method for clearing the session cache requires the verbose command:

cgip session -v

This is cumbersome for regular use.

Proposed Enhancement

Introduce a simpler clear subcommand to enhance user-friendliness:

cgip clear

Additional Consideration

To make session management even more flexible, consider distinguishing between a "soft" and a "hard" clear:

• Soft Clear: Marks a point in the session file where everything above is not used, allowing users to retain their history.
• Hard Clear: Completely removes items older than a certain point, ensuring older contexts are permanently deleted.

This enhancement will require modifications to the context window management, ensuring that items older than a specified number are retained for historical access if a soft clear is performed.

Benefits

• Simplifies the command for clearing the session cache, improving user experience.
• Enhances flexibility by offering users the ability to manage historical data along with the current active context.

Current vs. Proposed Methods

1. Current method to clear session cache:

   cgip session -v

2. Proposed method:

   cgip clear

Expected Outcome

• The cgip clear command should clear the session cache in a straightforward manner.
• Introduction of optional soft and hard clear functionalities:
  • Soft clear by default.
  • Use --hard flag for a full, irreversible delete.
  • Optionally, an --all flag to clear all session caches, ensuring the default does not clear everything by default.

Action Items:

• Implement the clear subcommand.
• Modify context window management to support soft and hard clear functionalities.
• Update the documentation to reflect these changes.