fix: improve cli output and docs (#129)

Author: vasco-santos

README.md

@@ -100,7 +100,7 @@ Commands:
   w3up info                Print information about cli
 
 Global:
-  -p, --profile  Select profile.                                                                         [string] [default: "main"]
+  -p, --profile Select profile configuration identifier.                                                 [string] [default: "main"]
 
 Options:
       --version  Show version number                                                                                      [boolean]
@@ -307,22 +307,22 @@ Once you have an identity registered with w3up, you can delegate capabilities to
 > Delegate capabilities to an agent did.
 
 ```sh
-w3up delegate did:12345...
-✔ Wrote delegation to delegation.car
+w3up delegate to did:12345...
+✔ Wrote delegation to delegation.txt
 ```
 
-A `delegation.car` file is generated with the UCAN delegation provided to the other agent with did `did:12345...`.
+A `delegation.txt` file is generated with the UCAN delegation provided to the other agent with did `did:12345...`.
 
 #### `w3up delegate import <fileName> [alias]`
 
 > Import a UCAN delegation file to access capabilities delegated by other agent
 
 ```sh
-w3up import-delegation delegation.car delegator
-✔ Imported delegation for delegator did:key:z6M... from delegation.car successfully.
+w3up import-delegation delegation.txt delegator
+✔ Imported delegation for delegator did:key:z6M... from delegation.txt successfully.
 ```
 
-Once a `delegation.car` is imported, you can switch to the account delegated:
+Once a `delegation.txt` is imported, you can switch to the account delegated:
 
 #### `w3up delegate switch [alias]`
 

src/commands/id.js

@@ -24,7 +24,6 @@ const handler = async (args) => {
   saveSettings(client, args.profile)
 
   view.succeed('Agent DID: ' + identity.agent.did())
-  view.succeed('Account DID: ' + identity.account.did())
 }
 /**
  * @type {import('yargs').CommandBuilder} yargs

src/commands/upload.js

@@ -56,8 +56,12 @@ async function generateCarUploads(filePath, view, chunkSize = 512, profile) {
       throw new Error(uploadAddResult?.cause?.message)
     }
 
-    console.log('data CIDs:\n', roots.map((x) => x.toString()).join('\n'))
+    console.log('upload chunk(s) identifier:\n', roots.map((x) => x.toString()).join('\n'))
     console.log('car CIDs:\n', cids.map((x) => x.toString()).join('\n'))
+
+    if (roots && roots.length) {
+      console.log(`IPFS Gateway url:\n https://w3s.link/ipfs/${roots[0].toString()}`)
+    }
   } catch (err) {
     view.fail('Upload did not complete successfully, check w3up-failure.log')
     logToFile('upload', err)

src/main.js

@@ -28,7 +28,7 @@ export const main = async (args = hideBin(process.argv)) => {
     .option('p', {
       alias: 'profile',
       type: 'string',
-      describe: 'Select profile.',
+      describe: 'Select profile configuration identifier.',
       default: 'main',
     })
     .group('profile', 'Global:')