Simply the api_package_orphan and api_package_unorphan per @abadger's advice

Add some documentation as to why we store output=ok even if there are
errors and only store message if there is one
Update api_package_retire to behave like api_package_orphan

This means /api/package/retire will support call to retire a package in
branches that the package does not have.