From 988f09979cfd1ee1cc629514e5293e7fe6f2f4bc Mon Sep 17 00:00:00 2001 From: Phil Ratzloff Date: Fri, 5 Jun 2026 12:38:32 -0400 Subject: [PATCH 1/2] Move agents to .github/agents --- .../agents}/algorithm_doc_guide.md | 0 .../agents}/archive/PHASE4_1_ISSUES.md | 0 .../agents}/archive/algo_prep.md | 0 .../algorithm_infrastructure_complete.md | 0 {agents => .github/agents}/archive/art_pts.md | 0 .../agents}/archive/bgl_graph_adapt_goal.md | 0 .../agents}/archive/bgl_graph_adapt_plan.md | 0 .../archive/bgl_graph_adapt_strategy.md | 0 .../agents}/archive/biconn_comp.md | 0 .../agents}/archive/cmake_plan.md | 0 .../agents}/archive/cmake_todo.md | 0 .../agents}/archive/cpo_extraction_summary.md | 0 .../agents}/archive/design_review.md | 0 .../agents}/archive/design_review_results.md | 0 ...ijkstra_shortest_paths_refactoring_plan.md | 0 .../agents}/archive/doc_refactor_plan.md | 0 .../agents}/archive/doc_refactor_strategy.md | 0 .../agents}/archive/doc_revision_plan.md | 0 .../agents}/archive/dygraph_plan.md | 0 .../archive/dynamic_edge_refactor_plan.md | 0 .../archive/dynamic_edge_refactor_strategy.md | 0 .../agents}/archive/dynamic_graph_todo.md | 0 .../agents}/archive/edge_list_goal.md | 0 .../agents}/archive/edge_list_plan.md | 0 .../agents}/archive/edge_list_strategy.md | 0 .../agents}/archive/incoming_edges_design.md | 0 .../agents}/archive/incoming_edges_plan.md | 0 .../archive/index_vertex_descriptor_plan.md | 0 .../agents}/archive/jaccard_coef.md | 0 .../agents}/archive/lbl_prop.md | 0 .../agents}/archive/map_container_plan.md | 0 .../agents}/archive/map_container_strategy.md | 0 .../agents}/archive/ns_refactor.md | 0 .../agents}/archive/overall_plan.md | 0 .../test_reorganization_execution_plan.md | 0 .../archive/test_reorganization_strategy.md | 0 ...ected_adjacency_list_base_refactor_plan.md | 0 ...d_adjacency_list_base_refactor_strategy.md | 0 .../undirected_adjlist_conformance_report.md | 0 .../archive/undirected_adjlist_plan.md | 0 .../archive/unordered_adjlist.review.md | 0 .../agents}/archive/value_function_goal.md | 0 .../value_function_implementation_plan.md | 0 .../archive/vertex_id_const_ref_plan.md | 0 .../archive/vertex_id_const_ref_strategy.md | 0 .../agents}/archive/view_goal.md | 0 .../agents}/archive/view_plan.md | 0 .../agents}/archive/view_signature_goal.md | 0 .../agents}/archive/view_signature_plan.md | 0 .../agents}/archive/view_strategy.md | 0 .../agents}/bgl2_comparison_query.md | 0 .../agents}/bgl2_comparison_result.md | 0 .../agents}/bgl_migration_strategy.md | 0 .../dary_heap/csr_edge_value_perf_plan.md | 0 .../agents}/dary_heap/findings_summary.md | 0 .../dary_heap/indexed_dary_heap_baseline.md | 0 .../indexed_dary_heap_baseline_msvc.md | 0 .../dary_heap/indexed_dary_heap_plan.md | 0 .../dary_heap/indexed_dary_heap_results.md | 0 .../dary_heap/perf_capture_manifest.txt | 0 .../dary_heap/perf_capture_manifest_linux.txt | 0 .../dary_heap/perf_linux_gcc_inventory.md | 0 .../dary_heap/perf_msvc_profile_inventory.md | 0 .../dary_heap/thread_b_linux_runbook.md | 0 .../agents}/multi_type_analysis.md | 0 .../agents}/uniform_prop_goal.md | 0 .../agents}/uniform_prop_strategy.md | 0 .../agents}/wg21_function_semantics.md | 0 .../agents}/wg21_proposal_guide.md | 0 AdaptingThirdPartyGraph/CMakeLists.txt | 12 --- .../adapting_a_third_party_graph.cpp | 83 ------------------- 71 files changed, 95 deletions(-) rename {agents => .github/agents}/algorithm_doc_guide.md (100%) rename {agents => .github/agents}/archive/PHASE4_1_ISSUES.md (100%) rename {agents => .github/agents}/archive/algo_prep.md (100%) rename {agents => .github/agents}/archive/algorithm_infrastructure_complete.md (100%) rename {agents => .github/agents}/archive/art_pts.md (100%) rename {agents => .github/agents}/archive/bgl_graph_adapt_goal.md (100%) rename {agents => .github/agents}/archive/bgl_graph_adapt_plan.md (100%) rename {agents => .github/agents}/archive/bgl_graph_adapt_strategy.md (100%) rename {agents => .github/agents}/archive/biconn_comp.md (100%) rename {agents => .github/agents}/archive/cmake_plan.md (100%) rename {agents => .github/agents}/archive/cmake_todo.md (100%) rename {agents => .github/agents}/archive/cpo_extraction_summary.md (100%) rename {agents => .github/agents}/archive/design_review.md (100%) rename {agents => .github/agents}/archive/design_review_results.md (100%) rename {agents => .github/agents}/archive/dijkstra_shortest_paths_refactoring_plan.md (100%) rename {agents => .github/agents}/archive/doc_refactor_plan.md (100%) rename {agents => .github/agents}/archive/doc_refactor_strategy.md (100%) rename {agents => .github/agents}/archive/doc_revision_plan.md (100%) rename {agents => .github/agents}/archive/dygraph_plan.md (100%) rename {agents => .github/agents}/archive/dynamic_edge_refactor_plan.md (100%) rename {agents => .github/agents}/archive/dynamic_edge_refactor_strategy.md (100%) rename {agents => .github/agents}/archive/dynamic_graph_todo.md (100%) rename {agents => .github/agents}/archive/edge_list_goal.md (100%) rename {agents => .github/agents}/archive/edge_list_plan.md (100%) rename {agents => .github/agents}/archive/edge_list_strategy.md (100%) rename {agents => .github/agents}/archive/incoming_edges_design.md (100%) rename {agents => .github/agents}/archive/incoming_edges_plan.md (100%) rename {agents => .github/agents}/archive/index_vertex_descriptor_plan.md (100%) rename {agents => .github/agents}/archive/jaccard_coef.md (100%) rename {agents => .github/agents}/archive/lbl_prop.md (100%) rename {agents => .github/agents}/archive/map_container_plan.md (100%) rename {agents => .github/agents}/archive/map_container_strategy.md (100%) rename {agents => .github/agents}/archive/ns_refactor.md (100%) rename {agents => .github/agents}/archive/overall_plan.md (100%) rename {agents => .github/agents}/archive/test_reorganization_execution_plan.md (100%) rename {agents => .github/agents}/archive/test_reorganization_strategy.md (100%) rename {agents => .github/agents}/archive/undirected_adjacency_list_base_refactor_plan.md (100%) rename {agents => .github/agents}/archive/undirected_adjacency_list_base_refactor_strategy.md (100%) rename {agents => .github/agents}/archive/undirected_adjlist_conformance_report.md (100%) rename {agents => .github/agents}/archive/undirected_adjlist_plan.md (100%) rename {agents => .github/agents}/archive/unordered_adjlist.review.md (100%) rename {agents => .github/agents}/archive/value_function_goal.md (100%) rename {agents => .github/agents}/archive/value_function_implementation_plan.md (100%) rename {agents => .github/agents}/archive/vertex_id_const_ref_plan.md (100%) rename {agents => .github/agents}/archive/vertex_id_const_ref_strategy.md (100%) rename {agents => .github/agents}/archive/view_goal.md (100%) rename {agents => .github/agents}/archive/view_plan.md (100%) rename {agents => .github/agents}/archive/view_signature_goal.md (100%) rename {agents => .github/agents}/archive/view_signature_plan.md (100%) rename {agents => .github/agents}/archive/view_strategy.md (100%) rename {agents => .github/agents}/bgl2_comparison_query.md (100%) rename {agents => .github/agents}/bgl2_comparison_result.md (100%) rename {agents => .github/agents}/bgl_migration_strategy.md (100%) rename {agents => .github/agents}/dary_heap/csr_edge_value_perf_plan.md (100%) rename {agents => .github/agents}/dary_heap/findings_summary.md (100%) rename {agents => .github/agents}/dary_heap/indexed_dary_heap_baseline.md (100%) rename {agents => .github/agents}/dary_heap/indexed_dary_heap_baseline_msvc.md (100%) rename {agents => .github/agents}/dary_heap/indexed_dary_heap_plan.md (100%) rename {agents => .github/agents}/dary_heap/indexed_dary_heap_results.md (100%) rename {agents => .github/agents}/dary_heap/perf_capture_manifest.txt (100%) rename {agents => .github/agents}/dary_heap/perf_capture_manifest_linux.txt (100%) rename {agents => .github/agents}/dary_heap/perf_linux_gcc_inventory.md (100%) rename {agents => .github/agents}/dary_heap/perf_msvc_profile_inventory.md (100%) rename {agents => .github/agents}/dary_heap/thread_b_linux_runbook.md (100%) rename {agents => .github/agents}/multi_type_analysis.md (100%) rename {agents => .github/agents}/uniform_prop_goal.md (100%) rename {agents => .github/agents}/uniform_prop_strategy.md (100%) rename {agents => .github/agents}/wg21_function_semantics.md (100%) rename {agents => .github/agents}/wg21_proposal_guide.md (100%) delete mode 100644 AdaptingThirdPartyGraph/CMakeLists.txt delete mode 100644 AdaptingThirdPartyGraph/adapting_a_third_party_graph.cpp diff --git a/agents/algorithm_doc_guide.md b/.github/agents/algorithm_doc_guide.md similarity index 100% rename from agents/algorithm_doc_guide.md rename to .github/agents/algorithm_doc_guide.md diff --git a/agents/archive/PHASE4_1_ISSUES.md b/.github/agents/archive/PHASE4_1_ISSUES.md similarity index 100% rename from agents/archive/PHASE4_1_ISSUES.md rename to .github/agents/archive/PHASE4_1_ISSUES.md diff --git a/agents/archive/algo_prep.md b/.github/agents/archive/algo_prep.md similarity index 100% rename from agents/archive/algo_prep.md rename to .github/agents/archive/algo_prep.md diff --git a/agents/archive/algorithm_infrastructure_complete.md b/.github/agents/archive/algorithm_infrastructure_complete.md similarity index 100% rename from agents/archive/algorithm_infrastructure_complete.md rename to .github/agents/archive/algorithm_infrastructure_complete.md diff --git a/agents/archive/art_pts.md b/.github/agents/archive/art_pts.md similarity index 100% rename from agents/archive/art_pts.md rename to .github/agents/archive/art_pts.md diff --git a/agents/archive/bgl_graph_adapt_goal.md b/.github/agents/archive/bgl_graph_adapt_goal.md similarity index 100% rename from agents/archive/bgl_graph_adapt_goal.md rename to .github/agents/archive/bgl_graph_adapt_goal.md diff --git a/agents/archive/bgl_graph_adapt_plan.md b/.github/agents/archive/bgl_graph_adapt_plan.md similarity index 100% rename from agents/archive/bgl_graph_adapt_plan.md rename to .github/agents/archive/bgl_graph_adapt_plan.md diff --git a/agents/archive/bgl_graph_adapt_strategy.md b/.github/agents/archive/bgl_graph_adapt_strategy.md similarity index 100% rename from agents/archive/bgl_graph_adapt_strategy.md rename to .github/agents/archive/bgl_graph_adapt_strategy.md diff --git a/agents/archive/biconn_comp.md b/.github/agents/archive/biconn_comp.md similarity index 100% rename from agents/archive/biconn_comp.md rename to .github/agents/archive/biconn_comp.md diff --git a/agents/archive/cmake_plan.md b/.github/agents/archive/cmake_plan.md similarity index 100% rename from agents/archive/cmake_plan.md rename to .github/agents/archive/cmake_plan.md diff --git a/agents/archive/cmake_todo.md b/.github/agents/archive/cmake_todo.md similarity index 100% rename from agents/archive/cmake_todo.md rename to .github/agents/archive/cmake_todo.md diff --git a/agents/archive/cpo_extraction_summary.md b/.github/agents/archive/cpo_extraction_summary.md similarity index 100% rename from agents/archive/cpo_extraction_summary.md rename to .github/agents/archive/cpo_extraction_summary.md diff --git a/agents/archive/design_review.md b/.github/agents/archive/design_review.md similarity index 100% rename from agents/archive/design_review.md rename to .github/agents/archive/design_review.md diff --git a/agents/archive/design_review_results.md b/.github/agents/archive/design_review_results.md similarity index 100% rename from agents/archive/design_review_results.md rename to .github/agents/archive/design_review_results.md diff --git a/agents/archive/dijkstra_shortest_paths_refactoring_plan.md b/.github/agents/archive/dijkstra_shortest_paths_refactoring_plan.md similarity index 100% rename from agents/archive/dijkstra_shortest_paths_refactoring_plan.md rename to .github/agents/archive/dijkstra_shortest_paths_refactoring_plan.md diff --git a/agents/archive/doc_refactor_plan.md b/.github/agents/archive/doc_refactor_plan.md similarity index 100% rename from agents/archive/doc_refactor_plan.md rename to .github/agents/archive/doc_refactor_plan.md diff --git a/agents/archive/doc_refactor_strategy.md b/.github/agents/archive/doc_refactor_strategy.md similarity index 100% rename from agents/archive/doc_refactor_strategy.md rename to .github/agents/archive/doc_refactor_strategy.md diff --git a/agents/archive/doc_revision_plan.md b/.github/agents/archive/doc_revision_plan.md similarity index 100% rename from agents/archive/doc_revision_plan.md rename to .github/agents/archive/doc_revision_plan.md diff --git a/agents/archive/dygraph_plan.md b/.github/agents/archive/dygraph_plan.md similarity index 100% rename from agents/archive/dygraph_plan.md rename to .github/agents/archive/dygraph_plan.md diff --git a/agents/archive/dynamic_edge_refactor_plan.md b/.github/agents/archive/dynamic_edge_refactor_plan.md similarity index 100% rename from agents/archive/dynamic_edge_refactor_plan.md rename to .github/agents/archive/dynamic_edge_refactor_plan.md diff --git a/agents/archive/dynamic_edge_refactor_strategy.md b/.github/agents/archive/dynamic_edge_refactor_strategy.md similarity index 100% rename from agents/archive/dynamic_edge_refactor_strategy.md rename to .github/agents/archive/dynamic_edge_refactor_strategy.md diff --git a/agents/archive/dynamic_graph_todo.md b/.github/agents/archive/dynamic_graph_todo.md similarity index 100% rename from agents/archive/dynamic_graph_todo.md rename to .github/agents/archive/dynamic_graph_todo.md diff --git a/agents/archive/edge_list_goal.md b/.github/agents/archive/edge_list_goal.md similarity index 100% rename from agents/archive/edge_list_goal.md rename to .github/agents/archive/edge_list_goal.md diff --git a/agents/archive/edge_list_plan.md b/.github/agents/archive/edge_list_plan.md similarity index 100% rename from agents/archive/edge_list_plan.md rename to .github/agents/archive/edge_list_plan.md diff --git a/agents/archive/edge_list_strategy.md b/.github/agents/archive/edge_list_strategy.md similarity index 100% rename from agents/archive/edge_list_strategy.md rename to .github/agents/archive/edge_list_strategy.md diff --git a/agents/archive/incoming_edges_design.md b/.github/agents/archive/incoming_edges_design.md similarity index 100% rename from agents/archive/incoming_edges_design.md rename to .github/agents/archive/incoming_edges_design.md diff --git a/agents/archive/incoming_edges_plan.md b/.github/agents/archive/incoming_edges_plan.md similarity index 100% rename from agents/archive/incoming_edges_plan.md rename to .github/agents/archive/incoming_edges_plan.md diff --git a/agents/archive/index_vertex_descriptor_plan.md b/.github/agents/archive/index_vertex_descriptor_plan.md similarity index 100% rename from agents/archive/index_vertex_descriptor_plan.md rename to .github/agents/archive/index_vertex_descriptor_plan.md diff --git a/agents/archive/jaccard_coef.md b/.github/agents/archive/jaccard_coef.md similarity index 100% rename from agents/archive/jaccard_coef.md rename to .github/agents/archive/jaccard_coef.md diff --git a/agents/archive/lbl_prop.md b/.github/agents/archive/lbl_prop.md similarity index 100% rename from agents/archive/lbl_prop.md rename to .github/agents/archive/lbl_prop.md diff --git a/agents/archive/map_container_plan.md b/.github/agents/archive/map_container_plan.md similarity index 100% rename from agents/archive/map_container_plan.md rename to .github/agents/archive/map_container_plan.md diff --git a/agents/archive/map_container_strategy.md b/.github/agents/archive/map_container_strategy.md similarity index 100% rename from agents/archive/map_container_strategy.md rename to .github/agents/archive/map_container_strategy.md diff --git a/agents/archive/ns_refactor.md b/.github/agents/archive/ns_refactor.md similarity index 100% rename from agents/archive/ns_refactor.md rename to .github/agents/archive/ns_refactor.md diff --git a/agents/archive/overall_plan.md b/.github/agents/archive/overall_plan.md similarity index 100% rename from agents/archive/overall_plan.md rename to .github/agents/archive/overall_plan.md diff --git a/agents/archive/test_reorganization_execution_plan.md b/.github/agents/archive/test_reorganization_execution_plan.md similarity index 100% rename from agents/archive/test_reorganization_execution_plan.md rename to .github/agents/archive/test_reorganization_execution_plan.md diff --git a/agents/archive/test_reorganization_strategy.md b/.github/agents/archive/test_reorganization_strategy.md similarity index 100% rename from agents/archive/test_reorganization_strategy.md rename to .github/agents/archive/test_reorganization_strategy.md diff --git a/agents/archive/undirected_adjacency_list_base_refactor_plan.md b/.github/agents/archive/undirected_adjacency_list_base_refactor_plan.md similarity index 100% rename from agents/archive/undirected_adjacency_list_base_refactor_plan.md rename to .github/agents/archive/undirected_adjacency_list_base_refactor_plan.md diff --git a/agents/archive/undirected_adjacency_list_base_refactor_strategy.md b/.github/agents/archive/undirected_adjacency_list_base_refactor_strategy.md similarity index 100% rename from agents/archive/undirected_adjacency_list_base_refactor_strategy.md rename to .github/agents/archive/undirected_adjacency_list_base_refactor_strategy.md diff --git a/agents/archive/undirected_adjlist_conformance_report.md b/.github/agents/archive/undirected_adjlist_conformance_report.md similarity index 100% rename from agents/archive/undirected_adjlist_conformance_report.md rename to .github/agents/archive/undirected_adjlist_conformance_report.md diff --git a/agents/archive/undirected_adjlist_plan.md b/.github/agents/archive/undirected_adjlist_plan.md similarity index 100% rename from agents/archive/undirected_adjlist_plan.md rename to .github/agents/archive/undirected_adjlist_plan.md diff --git a/agents/archive/unordered_adjlist.review.md b/.github/agents/archive/unordered_adjlist.review.md similarity index 100% rename from agents/archive/unordered_adjlist.review.md rename to .github/agents/archive/unordered_adjlist.review.md diff --git a/agents/archive/value_function_goal.md b/.github/agents/archive/value_function_goal.md similarity index 100% rename from agents/archive/value_function_goal.md rename to .github/agents/archive/value_function_goal.md diff --git a/agents/archive/value_function_implementation_plan.md b/.github/agents/archive/value_function_implementation_plan.md similarity index 100% rename from agents/archive/value_function_implementation_plan.md rename to .github/agents/archive/value_function_implementation_plan.md diff --git a/agents/archive/vertex_id_const_ref_plan.md b/.github/agents/archive/vertex_id_const_ref_plan.md similarity index 100% rename from agents/archive/vertex_id_const_ref_plan.md rename to .github/agents/archive/vertex_id_const_ref_plan.md diff --git a/agents/archive/vertex_id_const_ref_strategy.md b/.github/agents/archive/vertex_id_const_ref_strategy.md similarity index 100% rename from agents/archive/vertex_id_const_ref_strategy.md rename to .github/agents/archive/vertex_id_const_ref_strategy.md diff --git a/agents/archive/view_goal.md b/.github/agents/archive/view_goal.md similarity index 100% rename from agents/archive/view_goal.md rename to .github/agents/archive/view_goal.md diff --git a/agents/archive/view_plan.md b/.github/agents/archive/view_plan.md similarity index 100% rename from agents/archive/view_plan.md rename to .github/agents/archive/view_plan.md diff --git a/agents/archive/view_signature_goal.md b/.github/agents/archive/view_signature_goal.md similarity index 100% rename from agents/archive/view_signature_goal.md rename to .github/agents/archive/view_signature_goal.md diff --git a/agents/archive/view_signature_plan.md b/.github/agents/archive/view_signature_plan.md similarity index 100% rename from agents/archive/view_signature_plan.md rename to .github/agents/archive/view_signature_plan.md diff --git a/agents/archive/view_strategy.md b/.github/agents/archive/view_strategy.md similarity index 100% rename from agents/archive/view_strategy.md rename to .github/agents/archive/view_strategy.md diff --git a/agents/bgl2_comparison_query.md b/.github/agents/bgl2_comparison_query.md similarity index 100% rename from agents/bgl2_comparison_query.md rename to .github/agents/bgl2_comparison_query.md diff --git a/agents/bgl2_comparison_result.md b/.github/agents/bgl2_comparison_result.md similarity index 100% rename from agents/bgl2_comparison_result.md rename to .github/agents/bgl2_comparison_result.md diff --git a/agents/bgl_migration_strategy.md b/.github/agents/bgl_migration_strategy.md similarity index 100% rename from agents/bgl_migration_strategy.md rename to .github/agents/bgl_migration_strategy.md diff --git a/agents/dary_heap/csr_edge_value_perf_plan.md b/.github/agents/dary_heap/csr_edge_value_perf_plan.md similarity index 100% rename from agents/dary_heap/csr_edge_value_perf_plan.md rename to .github/agents/dary_heap/csr_edge_value_perf_plan.md diff --git a/agents/dary_heap/findings_summary.md b/.github/agents/dary_heap/findings_summary.md similarity index 100% rename from agents/dary_heap/findings_summary.md rename to .github/agents/dary_heap/findings_summary.md diff --git a/agents/dary_heap/indexed_dary_heap_baseline.md b/.github/agents/dary_heap/indexed_dary_heap_baseline.md similarity index 100% rename from agents/dary_heap/indexed_dary_heap_baseline.md rename to .github/agents/dary_heap/indexed_dary_heap_baseline.md diff --git a/agents/dary_heap/indexed_dary_heap_baseline_msvc.md b/.github/agents/dary_heap/indexed_dary_heap_baseline_msvc.md similarity index 100% rename from agents/dary_heap/indexed_dary_heap_baseline_msvc.md rename to .github/agents/dary_heap/indexed_dary_heap_baseline_msvc.md diff --git a/agents/dary_heap/indexed_dary_heap_plan.md b/.github/agents/dary_heap/indexed_dary_heap_plan.md similarity index 100% rename from agents/dary_heap/indexed_dary_heap_plan.md rename to .github/agents/dary_heap/indexed_dary_heap_plan.md diff --git a/agents/dary_heap/indexed_dary_heap_results.md b/.github/agents/dary_heap/indexed_dary_heap_results.md similarity index 100% rename from agents/dary_heap/indexed_dary_heap_results.md rename to .github/agents/dary_heap/indexed_dary_heap_results.md diff --git a/agents/dary_heap/perf_capture_manifest.txt b/.github/agents/dary_heap/perf_capture_manifest.txt similarity index 100% rename from agents/dary_heap/perf_capture_manifest.txt rename to .github/agents/dary_heap/perf_capture_manifest.txt diff --git a/agents/dary_heap/perf_capture_manifest_linux.txt b/.github/agents/dary_heap/perf_capture_manifest_linux.txt similarity index 100% rename from agents/dary_heap/perf_capture_manifest_linux.txt rename to .github/agents/dary_heap/perf_capture_manifest_linux.txt diff --git a/agents/dary_heap/perf_linux_gcc_inventory.md b/.github/agents/dary_heap/perf_linux_gcc_inventory.md similarity index 100% rename from agents/dary_heap/perf_linux_gcc_inventory.md rename to .github/agents/dary_heap/perf_linux_gcc_inventory.md diff --git a/agents/dary_heap/perf_msvc_profile_inventory.md b/.github/agents/dary_heap/perf_msvc_profile_inventory.md similarity index 100% rename from agents/dary_heap/perf_msvc_profile_inventory.md rename to .github/agents/dary_heap/perf_msvc_profile_inventory.md diff --git a/agents/dary_heap/thread_b_linux_runbook.md b/.github/agents/dary_heap/thread_b_linux_runbook.md similarity index 100% rename from agents/dary_heap/thread_b_linux_runbook.md rename to .github/agents/dary_heap/thread_b_linux_runbook.md diff --git a/agents/multi_type_analysis.md b/.github/agents/multi_type_analysis.md similarity index 100% rename from agents/multi_type_analysis.md rename to .github/agents/multi_type_analysis.md diff --git a/agents/uniform_prop_goal.md b/.github/agents/uniform_prop_goal.md similarity index 100% rename from agents/uniform_prop_goal.md rename to .github/agents/uniform_prop_goal.md diff --git a/agents/uniform_prop_strategy.md b/.github/agents/uniform_prop_strategy.md similarity index 100% rename from agents/uniform_prop_strategy.md rename to .github/agents/uniform_prop_strategy.md diff --git a/agents/wg21_function_semantics.md b/.github/agents/wg21_function_semantics.md similarity index 100% rename from agents/wg21_function_semantics.md rename to .github/agents/wg21_function_semantics.md diff --git a/agents/wg21_proposal_guide.md b/.github/agents/wg21_proposal_guide.md similarity index 100% rename from agents/wg21_proposal_guide.md rename to .github/agents/wg21_proposal_guide.md diff --git a/AdaptingThirdPartyGraph/CMakeLists.txt b/AdaptingThirdPartyGraph/CMakeLists.txt deleted file mode 100644 index 5425e38..0000000 --- a/AdaptingThirdPartyGraph/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -# example/AdaptingThirdPartyGraph/CMakeLists.txt - -set(EXAMPLE_OUTPUT_DIR "${CMAKE_CURRENT_SOURCE_DIR}/output/") -add_compile_definitions(EXAMPLE_OUTPUT_DIR="${EXAMPLE_OUTPUT_DIR}") - -#add_library(catch_main STATIC catch_main.cpp) -#target_link_libraries(catch_main PUBLIC Catch2::Catch2) -#target_link_libraries(catch_main PRIVATE project_options) -#target_link_options(catch_main INTERFACE $<$:-pthread -fconcepts-diagnostics-depth=1>) - -add_executable(AdaptingThirdPartyGraph "adapting_a_third_party_graph.cpp") -target_link_libraries(AdaptingThirdPartyGraph PRIVATE project_warnings project_options catch_main Catch2::Catch2WithMain graph) diff --git a/AdaptingThirdPartyGraph/adapting_a_third_party_graph.cpp b/AdaptingThirdPartyGraph/adapting_a_third_party_graph.cpp deleted file mode 100644 index f397722..0000000 --- a/AdaptingThirdPartyGraph/adapting_a_third_party_graph.cpp +++ /dev/null @@ -1,83 +0,0 @@ -// Copyright (C) 2025 Andrzej Krzemienski. -// -// Use, modification, and distribution is subject to the Boost Software -// License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at -// http://www.boost.org/LICENSE_1_0.txt) -// -// This test file demonstrates how one can adapt one's own graph container for use with -// this Graph Library - -#include -#include -#include -#include -#include - - -namespace MyLibrary { // custom graph container, conceptually an adjacency list - -struct MyEdge { - std::string content; - int indexOfTarget; -}; - -struct MyVertex { - std::string content; - std::vector outEdges; -}; - -class MyGraph { - std::vector _vertices; - -public: - MyVertex const* getVertexByIndex(int index) const { return &_vertices[static_cast(index)]; } - - std::vector const& getAllVertices() const // !! one of customization points - { - return _vertices; - } // forced me to add this fun - - void setTopology(std::vector t) { _vertices = std::move(t); } -}; - -} // namespace MyLibrary - -namespace MyLibrary { // customization for graph, unintrusive - // although forcing me to provide `vertices()` is superfluous - -auto vertices(MyGraph const& g) { return std::views::all(g.getAllVertices()); } // for vertex_range_t - -auto edges(MyGraph const&, const MyLibrary::MyVertex& v) { return std::views::all(v.outEdges); } - -auto edges(MyGraph const& g, int i) { return edges(g, *g.getVertexByIndex(i)); } - -int vertex_id(MyGraph const& g, std::vector::const_iterator it) { - return static_cast(std::distance(g.getAllVertices().begin(), it)); -} - -int target_id(MyGraph const&, MyEdge const& uv) { return uv.indexOfTarget; } - -} // namespace MyLibrary - - -int main() { - static_assert(graph::adjacency_list); - - const MyLibrary::MyGraph g = [] { // populate the graph - MyLibrary::MyGraph r; - std::vector topo{ - // A | - /*0*/ {"A", {{"", 1}, {"", 2}}}, // / \ | - /*1*/ {"B", {{"", 3}}}, // B C | - /*2*/ {"C", {{"", 3}}}, // \ / | - /*3*/ {"D", {}} // D | - }; - r.setTopology(std::move(topo)); - return r; - }(); - - for (auto const& [vid, v] : graph::views::vertices_depth_first_search(g, 0)) - std::cout << v.content << " "; - - std::cout << std::endl; -} \ No newline at end of file From 312b58c6199e3aadca32b46fccd65e5f52219955 Mon Sep 17 00:00:00 2001 From: Phil Ratzloff Date: Fri, 5 Jun 2026 12:45:13 -0400 Subject: [PATCH 2/2] Remove unconfirmed migration strategy statements --- .github/agents/bgl_migration_strategy.md | 29 ------------------------ 1 file changed, 29 deletions(-) diff --git a/.github/agents/bgl_migration_strategy.md b/.github/agents/bgl_migration_strategy.md index 326b881..09cdeab 100644 --- a/.github/agents/bgl_migration_strategy.md +++ b/.github/agents/bgl_migration_strategy.md @@ -1285,35 +1285,6 @@ namespace graph::compat { > **Recommendation:** A compatibility shim should be provided as a **separate, non-standardized** header — not part of the core library. It serves as a migration aid, not a long-term API. -### Standardization Strategy: Boost Incubation - -A recurring objection to standardizing graph-v3 is the absence of field usage — the design has not yet been validated by a real user base. This is an evidence gap, not a design flaw, and WG21/LEWG explicitly weigh "existing practice" when evaluating library proposals. - -**Strategy: ship graph-v3 to Boost as a modern successor to BGL ("BGL2") to gather users, then feed the resulting field experience back into the standards proposals (P3126–P3131, P3337).** - -Why this strengthens — rather than competes with — the `std::graph` goal: - -- **It directly answers the objection.** Boost adoption produces real users, bug reports, performance data versus BGL, and API-friction reports that paper review cannot surface. -- **Strong precedent.** `filesystem`, `optional`, `variant`, `any`, and networking (`asio`) all incubated in Boost before moving toward `std`. A Boost library *is* existing practice. -- **Right audience.** Boost users are standards-aware early adopters who will exercise the concept constraints, CPO ergonomics, error-message quality, and adaptor composition that most need validation. -- **Built-in migration population.** Positioning as "modern BGL" inherits BGL's mindshare and gives the library an immediate user base (the audience this document serves). - -**Packaging guidance (avoid a fork):** - -- Keep the **canonical source in `namespace graph`** (the working name that migrates cleanly to `std::graph`). -- Present the Boost-facing name (e.g. `boost::graph2` or `boost::graph::v2`) as an **alias / inline-namespace layer** over the canonical namespace, **not** a rename or fork. One source of truth, two presented names. This keeps the eventual `std::graph` migration a near-mechanical re-alias. -- Use Boost's pre-acceptance "no stability guarantee" window to keep refining the design while usage data accrues, so a Boost release does not prematurely calcify the API/ABI that the proposal depends on. - -**Scope discipline:** the standardization core is the container / concept / CPO / traversal foundation (the core categories average ~78% in [Appendix C](#appendix-c-migration-readiness-scorecard)). Ship that foundation to Boost to validate it; the specialist algorithm domains still at 0% in Appendix A (flow, matching, coloring, planarity, isomorphism, ordering, layout) can land incrementally and block neither the Boost review nor the proposal. - -**Sequencing:** - -1. Boost release as "modern BGL," canonical `namespace graph` with a Boost-facing alias layer. -2. Collect usage: bug reports, benchmarks versus BGL, ergonomics/API-friction reports, and real-world coexistence testing of the CPO-suppresses-ADL behavior (see §11). -3. Feed refinements back into P3126–P3131 / P3337 as field-experience evidence. -4. Re-alias the validated subset into `std::graph`. - ---- ## Appendix C. Migration Readiness Scorecard