Merge pull request #57 from tarosky/feature/conversation-history

対話履歴の永続化と質問マイニング (#51)

Author: fumikito

README.md

@@ -112,6 +112,7 @@ You can contribute to our github repo. Any [issues](https://github.com/tarosky/h
 - Change ownership to Tarosky.
 - AI Overview now supports **multi-turn conversations**. Follow-up questions keep the previous exchanges as context, and answers stack as a Q&A thread. Conversation history is held in the browser and sent with each request, so nothing is stored on the server.
 - Add `hamelp_history_window` filter to limit how many prior messages are sent to the LLM (default 10).
+- Optionally **save conversations** for question mining (off by default). When enabled on the settings page, conversations are stored as a private post type viewable in the admin, so you can see what visitors actually ask. Toggle via the **Save Conversations** setting or the `hamelp_save_conversations` filter.
 
 ### 2.2.3
 

app/Hametuha/Hamelp/Hooks/AiOverview.php

@@ -8,6 +8,7 @@
 namespace Hametuha\Hamelp\Hooks;
 
 use Hametuha\Hamelp\Pattern\Singleton;
+use Hametuha\Hamelp\Services\ConversationStore;
 use Hametuha\Hamelp\Services\FaqSearchService;
 
 /**
@@ -43,18 +44,24 @@ public function register_routes() {
 				'callback'            => [ $this, 'handle_request' ],
 				'permission_callback' => [ $this, 'check_permission' ],
 				'args'                => [
-					'query'   => [
+					'query'           => [
 						'required'          => true,
 						'type'              => 'string',
 						'sanitize_callback' => 'sanitize_text_field',
 					],
-					'history' => [
+					'history'         => [
 						'required' => false,
 						'type'     => 'array',
 						'default'  => [],
 						// Items are associative arrays (role/content); sanitized
 						// and windowed in FaqSearchService::prepare_history().
 					],
+					'conversation_id' => [
+						'required'          => false,
+						'type'              => 'string',
+						'default'           => '',
+						'sanitize_callback' => 'sanitize_text_field',
+					],
 				],
 			]
 		);
@@ -208,6 +215,25 @@ public function handle_request( \WP_REST_Request $request ) {
 		// Increment rate counters on successful AI call.
 		$this->increment_rate_counters();
 
+		// Persist the exchange when conversation saving is enabled (opt-in).
+		// Done only after a successful answer so empty attempts are never stored.
+		$store = new ConversationStore();
+		if ( $store->is_enabled() ) {
+			$conversation_id = (string) $request->get_param( 'conversation_id' );
+			$saved           = $store->save_turn(
+				'' !== $conversation_id ? $conversation_id : null,
+				$query,
+				(string) $result['answer'],
+				$result['cited_ids'] ?? []
+			);
+			if ( ! empty( $saved['uuid'] ) ) {
+				$result['conversation_id'] = $saved['uuid'];
+			}
+		}
+
+		// cited_ids is internal; do not expose it in the API response.
+		unset( $result['cited_ids'] );
+
 		return rest_ensure_response( $result );
 	}
 }

app/Hametuha/Hamelp/Hooks/ConversationHistory.php

@@ -0,0 +1,97 @@
+<?php
+/**
+ * Conversation history hook handler.
+ *
+ * @package hamelp
+ */
+
+namespace Hametuha\Hamelp\Hooks;
+
+use Hametuha\Hamelp\Pattern\Singleton;
+use Hametuha\Hamelp\Services\ConversationStore;
+
+/**
+ * Registers the private conversation post type used for question mining.
+ *
+ * The post type is intentionally non-public: it is not queryable on the front
+ * end and is excluded from search and the REST listing. It is only surfaced in
+ * wp-admin so site owners can review what visitors actually asked.
+ */
+class ConversationHistory extends Singleton {
+
+	/**
+	 * Initialize hooks.
+	 */
+	protected function init() {
+		add_action( 'init', [ $this, 'register_post_type' ] );
+		add_filter( 'manage_' . ConversationStore::POST_TYPE . '_posts_columns', [ $this, 'columns' ] );
+		add_action( 'manage_' . ConversationStore::POST_TYPE . '_posts_custom_column', [ $this, 'render_column' ], 10, 2 );
+	}
+
+	/**
+	 * Register the conversation post type.
+	 */
+	public function register_post_type() {
+		register_post_type(
+			ConversationStore::POST_TYPE,
+			[
+				'label'               => __( 'Conversations', 'hamelp' ),
+				'labels'              => [
+					'name'          => __( 'Conversations', 'hamelp' ),
+					'singular_name' => __( 'Conversation', 'hamelp' ),
+					'menu_name'     => __( 'AI Conversations', 'hamelp' ),
+				],
+				'public'              => false,
+				'publicly_queryable'  => false,
+				'exclude_from_search' => true,
+				'show_ui'             => true,
+				'show_in_menu'        => true,
+				'show_in_rest'        => false,
+				'has_archive'         => false,
+				'rewrite'             => false,
+				'menu_icon'           => 'dashicons-format-chat',
+				'menu_position'       => 21,
+				'supports'            => [ 'title', 'editor', 'author' ],
+				'map_meta_cap'        => true,
+				// Read-only data: prevent creating new conversations by hand.
+				'capabilities'        => [
+					'create_posts' => 'do_not_allow',
+				],
+			]
+		);
+	}
+
+	/**
+	 * Customize admin list columns.
+	 *
+	 * @param array $columns Existing columns.
+	 * @return array
+	 */
+	public function columns( $columns ) {
+		$new = [];
+		foreach ( $columns as $key => $label ) {
+			if ( 'title' === $key ) {
+				$new[ $key ]  = __( 'First Question', 'hamelp' );
+				$new['turns'] = __( 'Turns', 'hamelp' );
+			} else {
+				$new[ $key ] = $label;
+			}
+		}
+		return $new;
+	}
+
+	/**
+	 * Render custom column values.
+	 *
+	 * @param string $column  Column key.
+	 * @param int    $post_id Post ID.
+	 */
+	public function render_column( $column, $post_id ) {
+		if ( 'turns' !== $column ) {
+			return;
+		}
+		$raw   = get_post_meta( $post_id, ConversationStore::META_TURNS, true );
+		$turns = $raw ? json_decode( $raw, true ) : [];
+		echo esc_html( is_array( $turns ) ? (string) count( $turns ) : '0' );
+	}
+}

app/Hametuha/Hamelp/Hooks/Settings.php

@@ -251,6 +251,36 @@ public function register_settings() {
 				]
 			);
 		}
+
+		// Conversation history (opt-in, disabled by default for privacy).
+		register_setting(
+			self::OPTION_GROUP,
+			'hamelp_save_conversations',
+			[
+				'type'              => 'string',
+				'sanitize_callback' => 'sanitize_text_field',
+				'default'           => '',
+			]
+		);
+
+		add_settings_section(
+			'hamelp_history_section',
+			__( 'Conversation History', 'hamelp' ),
+			[ $this, 'render_history_section' ],
+			self::PAGE_SLUG
+		);
+
+		add_settings_field(
+			'hamelp_save_conversations',
+			__( 'Save Conversations', 'hamelp' ),
+			[ $this, 'render_checkbox' ],
+			self::PAGE_SLUG,
+			'hamelp_history_section',
+			[
+				'option_name' => 'hamelp_save_conversations',
+				'description' => __( 'Store AI Overview conversations so you can review what visitors asked. Questions are saved to your database.', 'hamelp' ),
+			]
+		);
 	}
 
 	/**
@@ -341,6 +371,16 @@ public function render_rate_section() {
 		);
 	}
 
+	/**
+	 * Render conversation history section description.
+	 */
+	public function render_history_section() {
+		printf(
+			'<p>%s</p>',
+			esc_html__( 'Optionally keep a record of AI Overview conversations for question mining. Automatic deletion and privacy tools will be added in a future release.', 'hamelp' )
+		);
+	}
+
 	/**
 	 * Render a textarea field.
 	 *