Replace hierarchical terminology and update to v0.2.1-alpha

Matthew Valancy · Matthew Valancy · commit 49dacafa33e7 · 2025-08-17T20:20:09.000-07:00
- Change 'assignee' to 'contributor' throughout codebase
- Replace 'assignment' with 'contribution' and 'picked up'
- Update 'Unassigned' to 'Available' for better inclusivity
- Replace top-down language with peer collaboration terms
- Bump version to v0.2.1-alpha
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-GraphDone is a graph-native project management system that reimagines work coordination through dependencies and democratic prioritization rather than hierarchical assignments. The project is in active development (v0.2.0-alpha) with core architecture implemented and working foundation.
+GraphDone is a graph-native project management system that reimagines work coordination through dependencies and democratic prioritization rather than hierarchical assignments. The project is in active development (v0.2.1-alpha) with core architecture implemented and working foundation.
 
 ## Core Philosophy
 
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # GraphDone
 
-> Project management for teams who think differently. Coordinate through dependencies and outcomes, not hierarchies and assignments.
+> Project management for teams who think differently. Coordinate through dependencies and outcomes, not hierarchies and top-down control.
 
 ![GraphDone UI Screenshot](./docs/graphdone_ui.png)
 
@@ -24,7 +24,7 @@ GraphDone reimagines project management as a collaborative graph where work flow
 
 | Traditional PM | GraphDone |
 |----------------|-----------|
-| Hierarchical task assignment | Natural dependency flows |
+| Hierarchical task control | Natural dependency flows |
 | Manager-driven priorities | Democratic community validation |
 | Linear project timelines | Multi-level graph navigation |
 | Human-only collaboration | Human + AI peer collaboration |
diff --git a/docs/philosophy.md b/docs/philosophy.md
@@ -18,7 +18,7 @@ GraphDone visualizes work as it actually exists: a network of interconnected out
 
 ### People Contribute Best When They Choose How
 
-High-quality contributors are driven by intrinsic motivation - curiosity, mastery, purpose, and peer recognition. External pressure, arbitrary deadlines, and top-down assignments often reduce both quality and satisfaction.
+High-quality contributors are driven by intrinsic motivation - curiosity, mastery, purpose, and peer recognition. External pressure, arbitrary deadlines, and top-down directives often reduce both quality and satisfaction.
 
 Our graph-based approach lets people see what needs doing and choose their engagement path. Work becomes exploration rather than obligation.
 
@@ -143,6 +143,6 @@ We envision a world where:
 
 GraphDone is our contribution to this future - a tool that respects how people actually think, work, and collaborate while providing the coordination benefits of modern project management.
 
-From todo lists to todone lists. From assignments to explorations. From control to connection.
+From todo lists to todone lists. From directives to explorations. From control to connection.
 
 This is project management for people who think differently, built by people who think differently, in service of a more inclusive and effective future of work.
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "graphdone",
-  "version": "0.2.0-alpha",
+  "version": "0.2.1-alpha",
   "description": "Project management for teams who think differently",
   "private": true,
   "workspaces": [
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@graphdone/core",
-  "version": "0.2.0-alpha",
+  "version": "0.2.1-alpha",
   "description": "Core graph engine for GraphDone",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
diff --git a/packages/server/package.json b/packages/server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@graphdone/server",
-  "version": "0.2.0-alpha",
+  "version": "0.2.1-alpha",
   "description": "GraphQL API server for GraphDone",
   "main": "dist/index.js",
   "scripts": {
diff --git a/packages/server/src/scripts/seed.ts b/packages/server/src/scripts/seed.ts
@@ -197,7 +197,7 @@ async function seed() {
     console.log(`✅ Created ${contributors.length} contributors`);
     
     // Connect some contributors to work items
-    const assignments = [
+    const contributions = [
       { contributorId: 'contrib-1', workItemId: 'wi-1' },
       { contributorId: 'contrib-1', workItemId: 'wi-5' },
       { contributorId: 'contrib-2', workItemId: 'wi-6' },
@@ -206,15 +206,15 @@ async function seed() {
       { contributorId: 'contrib-5', workItemId: 'wi-9' }
     ];
     
-    for (const assignment of assignments) {
+    for (const contribution of contributions) {
       await session.run(
         `MATCH (c:Contributor {id: $contributorId})
          MATCH (w:WorkItem {id: $workItemId})
          CREATE (c)-[:CONTRIBUTES_TO]->(w)`,
-        assignment
+        contribution
       );
     }
-    console.log(`✅ Created ${assignments.length} contributor assignments`);
+    console.log(`✅ Created ${contributions.length} contributor connections`);
     
     console.log('🎉 Database seeding completed successfully!');
     
diff --git a/packages/web/.env.example b/packages/web/.env.example
@@ -4,7 +4,7 @@ VITE_GRAPHQL_WS_URL=ws://localhost:3127/graphql
 
 # App configuration
 VITE_APP_NAME=GraphDone
-VITE_APP_VERSION=0.2.0-alpha
+VITE_APP_VERSION=0.2.1-alpha
 
 # Feature flags
 VITE_ENABLE_SUBSCRIPTIONS=true
diff --git a/packages/web/index.html b/packages/web/index.html
@@ -8,7 +8,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="manifest" href="/manifest.json" />
     <title>GraphDone - Project Management Reimagined</title>
-    <meta name="description" content="Project management for teams who think differently. Coordinate through dependencies and outcomes, not hierarchies and assignments." />
+    <meta name="description" content="Project management for teams who think differently. Coordinate through dependencies and outcomes, not hierarchies and top-down control." />
   </head>
   <body>
     <div id="root">
diff --git a/packages/web/package.json b/packages/web/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@graphdone/web",
-  "version": "0.2.0-alpha",
+  "version": "0.2.1-alpha",
   "description": "React web application for GraphDone",
   "type": "module",
   "scripts": {
diff --git a/packages/web/src/components/Layout.tsx b/packages/web/src/components/Layout.tsx
@@ -107,7 +107,7 @@ export function Layout({ children }: LayoutProps) {
                 </div>
               )}
               <p className="text-xs text-gray-400">
-                v0.2.0-alpha
+                v0.2.1-alpha
               </p>
               <p className="text-xs text-gray-500 mt-1">
                 For teams who think differently
diff --git a/packages/web/src/components/ListView.tsx b/packages/web/src/components/ListView.tsx
@@ -55,7 +55,7 @@ export function ListView() {
   const [searchTerm, setSearchTerm] = useState('');
   const [typeFilter, setTypeFilter] = useState('All Types');
   const [statusFilter, setStatusFilter] = useState('All Statuses');
-  const [assigneeFilter, setAssigneeFilter] = useState('All Assignees');
+  const [contributorFilter, setContributorFilter] = useState('All Contributors');
   const [priorityFilter, setPriorityFilter] = useState('All Priorities');
   const [tagFilter, setTagFilter] = useState('');
   const dropdownRef = useRef<HTMLDivElement>(null);
@@ -73,13 +73,13 @@ export function ListView() {
   }, []);
 
   // Get unique values for filter options
-  const uniqueAssignees = useMemo(() => {
-    const assignees = mockProjectNodes
-      .map(node => node.assignee)
-      .filter(assignee => assignee)
-      .filter((assignee, index, arr) => arr.indexOf(assignee) === index)
+  const uniqueContributors = useMemo(() => {
+    const contributors = mockProjectNodes
+      .map(node => node.contributor)
+      .filter(contributor => contributor)
+      .filter((contributor, index, arr) => arr.indexOf(contributor) === index)
       .sort();
-    return assignees;
+    return contributors;
   }, []);
 
   const uniqueTags = useMemo(() => {
@@ -238,12 +238,12 @@ export function ListView() {
           )}
           
           <div className="flex items-center justify-between">
-            {node.assignee ? (
+            {node.contributor ? (
               <div className="flex items-center space-x-2">
-                <span className="text-gray-300 text-sm">{node.assignee}</span>
+                <span className="text-gray-300 text-sm">{node.contributor}</span>
               </div>
             ) : (
-              <span className="text-gray-500 text-sm">Unassigned</span>
+              <span className="text-gray-500 text-sm">Available</span>
             )}
           </div>
           
@@ -351,9 +351,9 @@ export function ListView() {
                       
                       <h4 className="text-white font-medium mb-2 line-clamp-2 text-base">{node.title}</h4>
                       
-                      {node.assignee && (
+                      {node.contributor && (
                         <div className="flex items-center space-x-2">
-                          <span className="text-gray-300 text-base">{node.assignee}</span>
+                          <span className="text-gray-300 text-base">{node.contributor}</span>
                         </div>
                       )}
                       
@@ -370,24 +370,24 @@ export function ListView() {
     );
   };
 
-  // Helper function to get assignee avatar
-  const getAssigneeAvatar = (assignee?: string) => {
-    if (!assignee) return null;
+  // Helper function to get contributor avatar
+  const getContributorAvatar = (contributor?: string) => {
+    if (!contributor) return null;
     
     // Generate avatar color based on name
     const colors = [
       'bg-blue-500', 'bg-green-500', 'bg-purple-500', 'bg-pink-500', 
       'bg-indigo-500', 'bg-red-500', 'bg-yellow-500', 'bg-teal-500'
     ];
-    const colorIndex = assignee.length % colors.length;
-    const initials = assignee.split(' ').map(n => n[0]).join('').toUpperCase().slice(0, 2);
+    const colorIndex = contributor.length % colors.length;
+    const initials = contributor.split(' ').map(n => n[0]).join('').toUpperCase().slice(0, 2);
     
     return (
       <div className="flex items-center space-x-2">
         <div className={`w-8 h-8 rounded-full ${colors[colorIndex]} flex items-center justify-center text-white text-xs font-medium`}>
           {initials}
         </div>
-        <span className="text-gray-300 text-sm">{assignee}</span>
+        <span className="text-gray-300 text-sm">{contributor}</span>
       </div>
     );
   };
@@ -452,14 +452,14 @@ export function ListView() {
                     </div>
                   </td>
                   <td className="pl-3 pr-6 py-10">
-                    {node.assignee ? (
-                      getAssigneeAvatar(node.assignee)
+                    {node.contributor ? (
+                      getContributorAvatar(node.contributor)
                     ) : (
                       <div className="flex items-center space-x-2">
                         <div className="w-8 h-8 rounded-full bg-gray-600 flex items-center justify-center">
                           <span className="text-gray-400 text-xs">?</span>
                         </div>
-                        <span className="text-gray-500 text-sm">Unassigned</span>
+                        <span className="text-gray-500 text-sm">Available</span>
                       </div>
                     )}
                   </td>
@@ -848,7 +848,7 @@ export function ListView() {
               </div>
               
               {/* Quick Clear Button */}
-              {(searchTerm || typeFilter !== 'All Types' || statusFilter !== 'All Statuses' || assigneeFilter !== 'All Assignees' || priorityFilter !== 'All Priorities' || tagFilter) && (
+              {(searchTerm || typeFilter !== 'All Types' || statusFilter !== 'All Statuses' || contributorFilter !== 'All Contributors' || priorityFilter !== 'All Priorities' || tagFilter) && (
                 <button
                   onClick={() => {
                     setSearchTerm('');
@@ -894,14 +894,14 @@ export function ListView() {
               </select>
 
               <select
-                value={assigneeFilter}
-                onChange={(e) => setAssigneeFilter(e.target.value)}
+                value={contributorFilter}
+                onChange={(e) => setContributorFilter(e.target.value)}
                 className="px-3 py-2 bg-gray-700 border border-gray-600 rounded-lg text-white text-sm focus:ring-2 focus:ring-green-500 focus:border-transparent"
               >
-                <option value="All Assignees">All Assignees</option>
-                <option value="Unassigned">Unassigned</option>
-                {uniqueAssignees.map(assignee => (
-                  <option key={assignee} value={assignee}>{assignee}</option>
+                <option value="All Contributors">All Contributors</option>
+                <option value="Unassigned">Available</option>
+                {uniqueContributors.map(contributor => (
+                  <option key={contributor} value={contributor}>{contributor}</option>
                 ))}
               </select>
 
@@ -931,7 +931,7 @@ export function ListView() {
             </div>
 
             {/* Active Filters Summary */}
-            {(searchTerm || typeFilter !== 'All Types' || statusFilter !== 'All Statuses' || assigneeFilter !== 'All Assignees' || priorityFilter !== 'All Priorities' || tagFilter) && (
+            {(searchTerm || typeFilter !== 'All Types' || statusFilter !== 'All Statuses' || contributorFilter !== 'All Contributors' || priorityFilter !== 'All Priorities' || tagFilter) && (
               <div className="flex items-center space-x-2 text-sm">
                 <span className="text-gray-400">Active filters:</span>
                 {searchTerm && (
@@ -949,9 +949,9 @@ export function ListView() {
                     Status: {statusFilter}
                   </span>
                 )}
-                {assigneeFilter !== 'All Assignees' && (
+                {contributorFilter !== 'All Contributors' && (
                   <span className="px-2 py-1 bg-yellow-900/30 text-yellow-300 rounded border border-yellow-500/30">
-                    Assignee: {assigneeFilter}
+                    Contributor: {contributorFilter}
                   </span>
                 )}
                 {priorityFilter !== 'All Priorities' && (
diff --git a/packages/web/src/components/TimelineView.tsx b/packages/web/src/components/TimelineView.tsx
diff --git a/packages/web/src/pages/Settings.tsx b/packages/web/src/pages/Settings.tsx
diff --git a/packages/web/src/types/projectData.ts b/packages/web/src/types/projectData.ts
diff --git a/tools/document.sh b/tools/document.sh

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "graphdone",`
`3`		`- "version": "0.2.0-alpha",`
	`3`	`+ "version": "0.2.1-alpha",`
`4`	`4`	`"description": "Project management for teams who think differently",`
`5`	`5`	`"private": true,`
`6`	`6`	`"workspaces": [`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@graphdone/core",`
`3`		`- "version": "0.2.0-alpha",`
	`3`	`+ "version": "0.2.1-alpha",`
`4`	`4`	`"description": "Core graph engine for GraphDone",`
`5`	`5`	`"main": "dist/index.js",`
`6`	`6`	`"types": "dist/index.d.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@graphdone/server",`
`3`		`- "version": "0.2.0-alpha",`
	`3`	`+ "version": "0.2.1-alpha",`
`4`	`4`	`"description": "GraphQL API server for GraphDone",`
`5`	`5`	`"main": "dist/index.js",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@graphdone/web",`
`3`		`- "version": "0.2.0-alpha",`
	`3`	`+ "version": "0.2.1-alpha",`
`4`	`4`	`"description": "React web application for GraphDone",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`