Updated repository specification. (#3050)

diff --git a/doc/repository-spec-v2.md b/doc/repository-spec-v2.md
index ef35d7a..6f9f597 100644
--- a/doc/repository-spec-v2.md
+++ b/doc/repository-spec-v2.md
@@ -44,8 +44,11 @@
 ```js
 {
   "name": "<PACKAGE>",
+  "isDiscontinued": true || false, /* optional field, missing if false */
+  "replacedBy": "<PACKAGE>", /* optional field, if isDiscontinued == true */
   "latest": {
     "version": "<VERSION>",
+    "isRetracted": true || false, /* optional field, missing if false */
     "archive_url": "https://.../archive.tar.gz",
     "pubspec": {
       /* pubspec contents as JSON object */
@@ -54,6 +57,7 @@
   "versions": [
     {
       "version": "<VERSION>",
+      "isRetracted": true || false, /* optional field, missing if false */
       "archive_url": "https://.../archive.tar.gz",
       "pubspec": {
         /* pubspec contents as JSON object */