{"id":27337891,"url":"https://github.com/rhizoome/graey","last_synced_at":"2025-04-12T15:25:12.959Z","repository":{"id":84184188,"uuid":"224317271","full_name":"rhizoome/graey","owner":"rhizoome","description":"My take on agil.","archived":false,"fork":false,"pushed_at":"2024-09-03T21:27:21.000Z","size":330,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-06T02:35:16.145Z","etag":null,"topics":["code-sharing","inactive"],"latest_commit_sha":null,"homepage":"https://rhizoome.ch/sharing","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rhizoome.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-27T01:20:10.000Z","updated_at":"2024-09-03T21:27:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"07863561-333b-4dee-9123-fcd9f0fa4895","html_url":"https://github.com/rhizoome/graey","commit_stats":null,"previous_names":["rhizoome/graey"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhizoome%2Fgraey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhizoome%2Fgraey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhizoome%2Fgraey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhizoome%2Fgraey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rhizoome","download_url":"https://codeload.github.com/rhizoome/graey/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248587795,"owners_count":21129296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-sharing","inactive"],"created_at":"2025-04-12T15:25:12.401Z","updated_at":"2025-04-12T15:25:12.925Z","avatar_url":"https://github.com/rhizoome.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"====\nGräy\n====\n\nMy take on agil.\n\nIt calculates/plots how much new work you discover while working on\na project. For example if you discover the same amount of work (or more)\nas you get done, you will never finish. However if you discover less work\nthan you get done, gräy will predict the total amount of work, using the slope\n(velocity) over the last 20 data-points. If there are less than 20 data-points\nit will use the last third of the data-points.\n\nYou can also add your own prediction of how much work you will discover. I call\nthis gräy tasks.\n\nGräy can only work if you update gräy as you complete actions or discover\nnew actions.\n\nRepository Status: Sharing / Inactive\n=====================================\n\nThis repository hosts code that I’ve chosen to share publicly for educational,\ndemonstration, or archival purposes. Please note the following:\n\n- **No Active Maintenance**: This project is not actively maintained or updated.\n  It serves primarily as a snapshot of a certain stage of development for those\n  who might find parts of the code useful or interesting. I try to accept pull-\n  request, but do not expect anything. If interest in the project increases, I\n  might change the repository status.\n- **No Support Provided**: As this is an inactive project, I’m unable to provide\n  support, answer issues, or accommodate pull requests.\n- **Use at Your Own Risk**: While you’re welcome to explore, fork, or use the\n  code in your own projects, please do so with the understanding that this\n  repository is provided as-is, without any guarantees on its functionality or\n  security.\n\nFeel free to explore the code and utilize it under the terms of the license\nattached to this repository!\n\nTerminology\n===========\n\nGräy task\n           A project can have a potential count of unknown tasks. The amount of\n           gräy tasks is estimated by the user. A gräy task takes the average\n           time of known tasks.\n\nTask\n           A task is built from actions. An action is an hour long (by\n           default).\n\nActions\n           Gräy works best if actions have a uniform duration and tasks have\n           a uniform count of actions. Gräy tries to deal with variability\n           by taking averages of the values needed for projections and\n           predictions.\n\nDuration\n           The time an actions, task or the whole project actually took in hours.\n\nEstimate\n           The time estimated for actions, task or the whole project.\n\nProjection\n           The projection is updated by the real duration when an action is done.\n           It is also corrected by the factor.\n\nFactor\n           The factor is the sum of durations diveded by the sum of estimates.\n\nPrediction\n           The prediction or trend is based on the corrected projection. It is\n           the total time project will take if velocity stays the same. The last\n           20 data-points are used for the prediction.\n\nVelocity\n           The proportion of completed work to newly discovered work.\n           It is the slope of the plotted curve.\n\nWork/Effort\n           The sum of time assosiated with the actions.\n\nFeatures\n========\n\n.. code-block:: text\n\n   $\u003e gry\n   Usage: gry [OPTIONS] COMMAND [ARGS]...\n   \n   Options:\n     --help  Show this message and exit.\n   \n   Commands:\n     add    add ACTION to TASK\n     csv    output as csv (projection, done)\n     del    delete an ACTION by id (see show)\n     done   complete an ACTION by id (DURATION in HHMM)\n     est    set default ESTIMATE\n     gry    set graey COUNT\n     merge  fix database after automatic or manual merge\n     plot   display plot\n     save   save plot as html\n     show   show open tasks\n     stats  display stats\n     tasks  show known tasks\n\nhtml\n----\n\nExample_\n\n.. _Example: https://1042.ch/42/ganwell/graey.html\n\nTasks\n-----\n\n.. code-block:: text\n\n   $\u003e gry tasks\n    ─────────────────────────────────────────────────────────────────────────────────\n     task   projection   projection (corr)   remaining   remaining (corr)   estimate\n    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n        b         5.00                9.20        3.00               7.20       5.00\n    ─────────────────────────────────────────────────────────────────────────────────\n        a        10.00               10.00        0.00               0.00       4.00\n    ─────────────────────────────────────────────────────────────────────────────────\n   average projection:     9.60h    |    average actions:     4.00\n\nShow\n----\n\nThe slowest sandwhich maker in the world:\n\n.. code-block:: text\n\n   $\u003e gry show\n    ───────────────────────────────────────────────────\n     id            task              action   estimate\n    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n      1   make sandwich           get bread        1.0\n    ───────────────────────────────────────────────────\n      2   make sandwich         slice bread        1.0\n    ───────────────────────────────────────────────────\n      3   make sandwich     get ingredients        1.0\n    ───────────────────────────────────────────────────\n      4   make sandwich   layer ingredients        1.0\n    ───────────────────────────────────────────────────\n      5   make sandwich                 eat        1.0\n    ───────────────────────────────────────────────────\n     gräy: 0   |   default estimate: 1.0\n\nStats\n-----\n\n.. code-block:: text\n\n   $\u003e gry stats\n   actions:                       8\n   actions (done):                8\n   actions (open):                0\n   tasks:                         2\n   tasks (done):                  2\n   tasks (open):                  0\n   tasks (gräy):                  0\n   tasks (avg. actions):          4.00\n   prediction data-points:        6\n   projection:                   17.00h\n   projection (corrected):       17.00h\n   projection (predicted):       17.00h\n   tasks (avg. projection):       8.50h\n   estimate:                      8.00h\n   correction factor:             2.12h\n   done:                         17.00h\n   remaining:                     0.00h\n   remaining (corrected):         0.00h\n   remaining (predicted):         0.00h\n\nTODO\n====\n\n* I guess the fixed count of 20 prediction data-points is a problem for a very\n  large project. I'm not sure if an option to plot and stats, is enough to fix\n  the problem.\n\n* merge\n\n* taskwarrior like IDs that don't change, but only get reused if it is free\n  agian\n\n* Use reuse for license\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhizoome%2Fgraey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhizoome%2Fgraey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhizoome%2Fgraey/lists"}