Archive TODO roadmap

Mark TODO.org as historical, add a brief current-work note, and
collapse the unplanned section into an archived summary.

Author: evolve75

TODO.org

@@ -4,6 +4,14 @@
 #+LINK: Issue https://github.com/evolve75/RubyTree/issues/%s
 #+LINK: Pull https://github.com/evolve75/RubyTree/pull/%s
 
+* Note
+  This file is a historical archive of release-era checklists (mostly R0.x–R2.x).
+  Current work should live in GitHub Issues/Projects and release checklists.
+
+* Current / Next
+  - Track active work in GitHub Issues and the release checklist for the target version.
+  - Keep this file for historical reference only.
+
 * R0.7.0                                                                                  :ARCHIVE:
 *** DONE Start using signed tags from R0.7.0                                              :ARCHIVE:
 *** DONE Add a check in the Tree::TreeNode.add method to prevent addition of nil child nodes :ARCHIVE:
@@ -210,63 +218,11 @@
 - [X] Update the documentation to reflect the modernization changes.
 
 
-* Unplanned / Not assigned to any release
-*** STARTED Convert all documentation to markdown mode.
-*** STARTED [#A] Resolve the infinite loop bug if a node is added to itself as a child     :Partial:
-   [[Issue:5][Issue #5.]]
-
-   This is a subtle problem to resolve.  The specific case of a node
-   being added to itself is trivial to resolve, and the fix has been
-   put in for 0.8.3.
-
-   However, the general problem is that in the current code, a node
-   can be added as a child to any portion of the tree down the
-   hierarchy (e.g., as a grandchild), which will need a more thorough
-   detection code in the ~TreeNode#add~ method, if it is to be done at
-   runtime.
-
-   The issue is really to prevent the tree becoming a graph.  Note
-   that the issue is with duplicate nodes, /not/ duplicated content.
-
-   A few options exist:
-   1. Perform a runtime check in the ~TreeNode#add~ method.  This will
-      cause a performance hit as the tree becomes larger.
-   2. Allow the additions to go through, but create a new ~validate~
-      method that checks for such cycles.
-   3. Create separate configuration object which can be attached to
-      the root of the tree, which allows per-tree configuration of
-      the behavior - this does allow for the user to take control,
-      but also introduces complications during tree mergers and
-      spitting subtrees.
-   4. Create a registry (to be maintained at the root?) of all nodes,
-      and use this for validating the node additions (and preventing
-      duplicates).  This needs to be a hash (to allow O(1) access),
-      and will sacrifice memory.  There might be a need to
-      restructure the internals to make better use of memory.
-*** TODO Expand the examples section, and add supporting documentation
-
-*** TODO Create a cycle-detection/validation mechanism to prevent cyclic graphs of nodes.
-*** TODO Create a generic validation method to check for various issues in the created tree.
-*** TODO Add a FAQ document to the project.
-*** TODO The semantic of length is probably unclear.  Should return the node_depth instead (or remove the method)
-    The current equivalence of length to size should also be removed.
-
-*** TODO Create the basic UML diagrams and upload to the Site
-    DEADLINE: <2010-01-04 Mon>
-
-*** TODO Add a YAML export method to the TreeNode class.
-
-*** TODO marshal_load method probably should be a class method.  It currently clobbers self.
-*** DONE Revert the forced install of rubygem 2.1.11 from [[file:.travis.yml][.travis.yml]]                     :ARCHIVE:
-    CLOSED: [2014-01-12 Sun 19:06]
-    The issue seems to have been resolved with the 2.2.1 release of Rubygems.
-*** DONE [#A] Migrate the website and references from http://rubyforge.org/               :ARCHIVE:
-    CLOSED: [2014-07-04 Fri 22:18]
-*** DONE Fix bug # [[http://rubyforge.org/tracker/index.php%3Ffunc%3Ddetail&aid%3D22535&group_id%3D1215&atid%3D4793][22535]]: The method Tree::TreeNode#depth is a misnomer.  The current definition actually provides the height function. :ARCHIVE:
-    DEADLINE: <2010-01-09 Sat> CLOSED: [2010-01-03 Sun 22:15]
-
-*** DONE Get the version control moved from CVS to Subversion (request submitted to RubyForge) :ARCHIVE:
-    CLOSED: [2010-01-02 Sat 17:58]
-
-*** DONE Add logic in Rakefile to read the file list from Manifest.txt file.              :ARCHIVE:
-  CLOSED: [2009-12-31 Thu 23:37]
+* Unplanned / Not assigned to any release                                                  :ARCHIVE:
+  This section is retained for historical context. Active items should be tracked in GitHub.
+
+*** DONE Convert all documentation to markdown mode.                                        :ARCHIVE:
+    Followed by ongoing maintenance in README and API-CHANGES.
+
+*** DONE Resolve the infinite loop bug if a node is added to itself as a child              :ARCHIVE:
+    [[Issue:5][Issue #5.]] is now addressed by cycle detection and validation guards.