TODO

   1 - [SCRIPTS] MediaWiki 1.9.3 and 1.6.7
   2
   3 - The merge interface is a kind of major UI disaster; you won't
   4   be able to use it unless you know how Git works.  Also, the
   5   merges can be quite difficult to resolve if upstream has made
   6   large formatting changes like reindenting.  We may also consider
   7   providing a --rebase option, which seems to do better when
   8   big problems like this show up.
   9
  10 - Repeated --continue from a temporary directory doesn't really work...
  11   (or maybe this interacts /really/ poorly with restore, in which case
  12   restore should ensure all files are present before actually doing the
  13   restore)
  14 - Should be able to run restore from /tmp directory
  15 - Show progress or something when upgrading
  16 - Allow 'sticky notes' for future upgraders to notice
  17 - Blacklist should allow an easy way for a user to override it,
  18   described in the error message.
  19 - .wizard/url semantics are subtly wrong: in particular, if we
  20   explicitly configure a URL at install, we should be able to
  21   detect this URL as baked in from the configuration
  22
  23 - gct has accidentally set the +x bit on a lot of files >.>.
  24 - Make gct do the right thing with no arguments
  25 - Rerere support doesn't actually work
  26 - Utility scripts gct should support multiple filenames
  27 - "Version 3.0.0 doesn't exist; did you mean 3.0?"
  28 - util.fetch() should use urllib under the hood, not httplib.  Code
  29   has to be changed.  We should log if we get redirected.
  30 - Be a little more intelligent when perform web checks; for example,
  31   if we get a forbidden message, that probably means we go the right
  32   address but it's blocked off; if we get a 404 message, that probably
  33   means wrong address. Account Unknown is something particularly good
  34   to check for.
  35 - Wordpress module can do something intelligent if we get redirected
  36   to the installation page.
  37 - The need to run egg_info can make things a little fragile when pulling
  38   if you forget.  How can we make this less easily forgotten?
  39 - wizardResolve* files seem to get left in tmp en-mass, and we don't
  40   know why.
  41
  42 - Plugin-ify! Hook-ify! In more detail, applications should all be moved
  43   out into plugins, scripts specific behavior should be moved into
  44   plugins, and hooks need to be made available so that we can exert
  45   the correct level of control.
  46
  47 - [SCRIPTS] Wordpress needs to get rid of the siteurl hack, so that it
  48   actually has a fully-qualified URL http://foo.scripts.mit.edu/blah.
  49   This will also fix Wordpress's cron functionality.  We should be
  50   careful not to write over users who are on vhosts.  We should figure
  51   out who is still on twiddle paths.  We should make sure the redirect
  52   is handled correctly.
  53
  54 - Remerges aren't reflected in the parent files, so `git diff` output is
  55   spurious.  Not sure how to fix this w/o tree hackery.
  56 - Sometimes users remove files. Well, if those files change, they automatically
  57   get marked as conflicted.  Maybe we should say for certain files "if they're
  58   gone, they're gone forever"?  What is the proper resolution?
  59
  60 - Parse output HTML for class="error" and give those errors back to the user (done),
  61   then boot them back into configure so they can enter in something different
  62
  63 - [SCRIPTS] If you try to do an install on scripts w/o sql, it will sign
  64   you up but fail to write the sql.cnf file. This sucks.
  65
  66 - [SCRIPTS] Web application for installing autoinstalls has a hard
  67   problem with credentials (as well as installations that are not
  68   conducted on an Athena machine.)  We have some crazy ideas involving a
  69   signed Java applet that uses jsch to SSH into athena.dialup and
  70   perform operations.
  71
  72 - Pay back code debt
  73     - Tidy up common code in callAsUser and drop_priviledges in shell;
  74       namely cooking up the sudo and environment variable lines
  75     - Summary script should be more machine friendly, and should not
  76       output summary charts when I increase specificity
  77
  78 - Other stuff
  79     - Add support for mypristine workflow
  80     - Figure out why Sphinx sometimes fails to crossref :func: but wil
  81       crossref :meth:, even though the dest is very clearly a function.
  82       Example: :func:`wizard.app.php.re_var`
  83     - The TODO extension for Sphinx doesn't properly force a full-rebuild
  84     - Make single user mass-migrate work when not logged in as root.  The
  85       primary difficulty is making the parallel-find information easily
  86       accessible to individual users: perhaps we can do a single-user
  87       parallel-find on the fly.
  88     - Don't use the scripts heuristics unless we're on scripts with the
  89       AFS patch.  Check with `fs sysname`
  90     - Make 'wizard summary' generate nice pretty graphs of installs by date
  91       (more histograms, will need to check actual .scripts-version files.)
  92     - It should be able to handle installs like Django where there's a component
  93       that gets installed in web_scripts and another directory that gets installed
  94       in Scripts.
  95
  96 - [SCRIPTS] ACLs is a starting point for sending mail to users, but it
  97   has several failure modes:
  98     - Old maintainers who don't care who are still on the ACL
  99     - Private AFS groups that aren't mailing lists and that we can't get
 100       to A question is whether or not sending mail actually helps us:
 101       many users will probably have to come back to us for help; many
 102       other users won't care.
 103     - Whatever happens here should be used to improve user.email()
 104
 105 [ XXX: metadata.rst ]
 106
 107 COMMIT MESSAGE FIELDS:
 108
 109 Installed-by: username@hostname
 110 Pre-commit-by: Real Name <username@mit.edu>
 111 Upgraded-by: Real Name <username@mit.edu>
 112 Migrated-by: Real Name <username@mit.edu>
 113 Wizard-revision: abcdef1234567890
 114 Wizard-args: /wizard/bin/wizard foo bar baz
 115
 116 GIT COMMIT FIELDS:
 117
 118 Committer: Real Name <username@mit.edu>
 119 Author: lockername locker <lockername@scripts.mit.edu>
 120
 121 OVERALL PLAN:
 122
 123 [ XXX: doc/deps.rst ]
 124 * Some parts of the infrastructure will not be touched, although I plan
 125   on documenting them.  Specifically, we will be keeping:
 126
 127     - get-homedirs.sh. which needs to be run as root on scripts.  Store
 128       in /mit/scripts/sec-tools/store/scriptslist
 129
 130     - parallel-find.pl, and the resulting
 131       /mit/scripts/sec-tools/store/versions
 132
 133 [ XXX: doc/deploy.rst ]
 134       GET APPROVAL BEFORE PROCEEDING ANY FURTHER;
 135       THIS IS PUSHING THE CHANGES TO THE PUBLIC
 136
 137       NOTE: The following commands are to be run on not-backward.mit.edu.
 138       You'll need to add daemon.scripts-security-upd to
 139       scripts-security-upd to get bits to do this.  Make sure you remove
 140       these bits when you're done.
 141
 142    10. Run `wizard research appname`
 143        which uses Git commands to check how many
 144        working copies apply the change cleanly, and writes out a logfile
 145        with the working copies that don't apply cleanly.  It also tells
 146        us about "corrupt" working copies, i.e. working copies that
 147        have over a certain threshold of changes.
 148
 149    11. Run `wizard mass-upgrade appname`, which applies the update to all working
 150        copies possible.
 151
 152    12. Run parallel-find.pl to update our inventory
 153
 154 [ XXX: doc/metadata.rst ]
 155 * The repository for a given application will contain the following files:
 156
 157     - The actual application's files, as from the official tarball
 158
 159     - A .scripts directory, with the intent of holding Scripts specific files
 160       if they become necessary.
 161
 162         - .scripts/dsn, overriding database source name
 163