build: migrate to the hyperledger-identus (#208)

* docs: add Identus platform specification

Signed-off-by: Yurii Shynbuiev <[email protected]>

* ci: migrate to hyperledger-identus org

Signed-off-by: Yurii Shynbuiev <[email protected]>

* fix: links in the docs

Signed-off-by: Yurii Shynbuiev <[email protected]>

* chore: temporary ignore the broken links

Signed-off-by: Yurii Shynbuiev <[email protected]>

* chore: update CODEOWNERS

Signed-off-by: Yurii Shynbuiev <[email protected]>

* revert: add Identus platform specification

This reverts commit fae187d.

Signed-off-by: Yurii Shynbuiev <[email protected]>

---------

Signed-off-by: Yurii Shynbuiev <[email protected]>

Author: yshyn-iohk

.github/CODEOWNERS

@@ -1,6 +1 @@
-# These owners will be the default owners for everything in
-# the repo. Unless a later match takes precedence
-* @petevielhaber @yshyn-iohk @amagyar-iohk @bvoiturier @lohanspies @mkbreuningIOHK @Dale-iohk @elribonazo @essbante-io
-
-# Docs:
-*.md @petevielhaber
+* @hyperledger-identus/identus-maintainers

.gitmodules

@@ -1,6 +1,6 @@
-[submodule "identus-cloud-agent"]
-	path = identus-cloud-agent
-	url = https://github.com/hyperledger/identus-cloud-agent.git
-[submodule "identus-edge-agent-sdk-ts"]
-	path = identus-edge-agent-sdk-ts
-	url = https://github.com/hyperledger/identus-edge-agent-sdk-ts.git
+[submodule "cloud-agent"]
+	path = cloud-agent
+	url = https://github.com/hyperledger-identus/cloud-agent
+[submodule "edge-agent-sdk-ts"]
+	path = edge-agent-sdk-ts
+	url = https://github.com/hyperledger-identus/edge-agent-sdk-ts

identus-cloud-agent renamed to cloud-agent

@@ -175,5 +175,5 @@ val result: Future[Seq[Person]] = db.run(q.result)
 - [Database access libraries in Scala](https://medium.com/@takezoe/database-access-libraries-in-scala-7aa7590aa3db)
 - [Typechecking SQL queries with doobie](https://godatadriven.com/blog/typechecking-sql-queries-with-doobie/)
 - [Typechecking SQL in Slick and doobie](https://underscore.io/blog/posts/2015/05/28/typechecking-sql.html)
-- [Doobie example in the Pollux library](https://github.com/hyperledger/identus-cloud-agent/blob/pollux-v0.17.0/pollux/lib/sql-doobie/src/main/scala/io/iohk/atala/pollux/sql/repository/JdbcCredentialRepository.scala)
-- [Quill example in the Pollux library](https://github.com/hyperledger/identus-cloud-agent/blob/pollux-v0.17.0/pollux/lib/sql-doobie/src/main/scala/io/iohk/atala/pollux/sql/model/VerifiableCredentialSchema.scala)
+- [Doobie example in the Pollux library](https://github.com/hyperledger-identus/cloud-agent/blob/pollux-v0.17.0/pollux/lib/sql-doobie/src/main/scala/io/iohk/atala/pollux/sql/repository/JdbcCredentialRepository.scala)
+- [Quill example in the Pollux library](https://github.com/hyperledger-identus/cloud-agent/blob/pollux-v0.17.0/pollux/lib/sql-doobie/src/main/scala/io/iohk/atala/pollux/sql/model/VerifiableCredentialSchema.scala)

documentation/adrs/decisions/2023-01-18-quill-library-for-sql-statement-generation.md

@@ -240,7 +240,7 @@ way to recover
 from an SQL execution error in a database-agnostic way.
 
 A good approach is to use ZIO Defects to report repository errors, declaring all repository methods as `URIO`
-or `UIO`([example](https://github.com/hyperledger/identus-cloud-agent/blob/main/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala)).
+or `UIO`([example](https://github.com/hyperledger-identus/cloud-agent/blob/main/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala)).
 Conversely, declaring them as `Task` assumes that the caller (i.e. service) can properly handle and
 recover from the low-level and database-specific exceptions exposed in the error channel, which is a fallacy.
 
@@ -251,7 +251,7 @@ trait ConnectionRepository {
 ```
 
 Converting a ZIO `Task` to ZIO `UIO` can easily be done
-using `ZIO#orDie`([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L114)).
+using `ZIO#orDie`([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L114)).
 
 ```scala
 class JdbcConnectionRepository(xa: Transactor[ContextAwareTask], xb: Transactor[Task]) extends ConnectionRepository {
@@ -276,7 +276,7 @@ class JdbcConnectionRepository(xa: Transactor[ContextAwareTask], xb: Transactor[
 ```
 
 For those cases where one has to generate a defect, a common way to do this is by using the following ZIO
-construct ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L212)):
+construct ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L212)):
 
 ```scala
 class JdbcConnectionRepository(xa: Transactor[ContextAwareTask], xb: Transactor[Task]) extends ConnectionRepository {
@@ -293,11 +293,11 @@ class JdbcConnectionRepository(xa: Transactor[ContextAwareTask], xb: Transactor[
 Follow the `get` and `find` best practices in the repository interface for read operations:
 
 - `getXxx()` returns the requested record or throws an unexpected exception/defect when not
-  found ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala#L36)).
+  found ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala#L36)).
 - `findXxx()` returns an `Option` with or without the request record, which allows the caller service to handle
   the `found`
   and `not-found` cases and report appropriately to the end
-  user ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala#L32)).
+  user ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/repository/ConnectionRepository.scala#L32)).
 
 ```scala
 trait ConnectionRepository {
@@ -312,7 +312,7 @@ trait ConnectionRepository {
 The `create`, `update` or `delete` repository methods should not return an `Int` indicating the number of rows affected
 by the operation but either return `Unit` when successful or throw an exception/defect when the row count is not what is
 expected, like i.e. an update operation resulting in a `0` affected row
-count ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L85)).
+count ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/sql-doobie/src/main/scala/io/iohk/atala/connect/sql/repository/JdbcConnectionRepository.scala#L85)).
 
 ```scala
 class JdbcConnectionRepository(xa: Transactor[ContextAwareTask], xb: Transactor[Task]) extends ConnectionRepository {
@@ -358,7 +358,7 @@ caught at the upper level and returns a generic `500 Internal Server Error` to t
 
 For those cases where a specific error like `404` should be returned, it is up to the service to first call `find()`
 before `update()` and construct a `NotFound` failure, propagated through the error channel, if it gives
-a `None` ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/service/ConnectionServiceImpl.scala#L149)).
+a `None` ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/service/ConnectionServiceImpl.scala#L149)).
 
 Relying on the service layer to implement it will guarantee consistent behavior regardless of the underlying database
 type (could be different RDMS flavor, No-SQL, etc.).
@@ -382,22 +382,22 @@ class ConnectionServiceImpl() extends ConnectionService {
 #### Do not type unexpected errors
 
 Do not wrap defects from lower layers (typically repository) in a failure and error case class declarations
-like [this](https://github.com/hyperledger/identus-cloud-agent/blob/b579fd86ab96db711425f511154e74be75583896/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L8)
+like [this](https://github.com/hyperledger-identus/cloud-agent/blob/b579fd86ab96db711425f511154e74be75583896/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L8)
 should be prohibited.
 
 Considering that failures are viewed as **expected errors** from which users can potentially recover, error case classes
 like `UnexpectedError` should be
-prohibited ([example](https://github.com/hyperledger/identus-cloud-agent/blob/b579fd86ab96db711425f511154e74be75583896/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L12)).
+prohibited ([example](https://github.com/hyperledger-identus/cloud-agent/blob/b579fd86ab96db711425f511154e74be75583896/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L12)).
 
 #### Extend the common `Failure` trait
 
 Make sure all service errors extend the shared
-trait [`org.hyperledger.identus.shared.models.Failure`](https://github.com/hyperledger/identus-cloud-agent/blob/main/shared/src/main/scala/io/iohk/atala/shared/models/Failure.scala).
+trait [`org.hyperledger.identus.shared.models.Failure`](https://github.com/hyperledger-identus/cloud-agent/blob/main/shared/src/main/scala/io/iohk/atala/shared/models/Failure.scala).
 This allows handling "at the end of the world“ to be done in a consistent and in generic way.
 
 Create an exhaustive and meaningful list of service errors and make sure the value of the `userFacingMessage` attribute
 is chosen wisely! It will present "as is" to the user and should not contain any sensitive
-data ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L14)).
+data ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/model/error/ConnectionServiceError.scala#L14)).
 
 ```scala
 trait Failure {
@@ -470,7 +470,7 @@ object ConnectionServiceError {
 #### Use Scala 3 Union Types
 
 Use Scala 3 union-types declaration in the effect’s error channel to notify the caller of potential
-failures ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/service/ConnectionServiceImpl.scala#L178))
+failures ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/connect/lib/core/src/main/scala/io/iohk/atala/connect/core/service/ConnectionServiceImpl.scala#L178))
 
 ````scala
 class ConnectionServiceImpl() extends ConnectionService {
@@ -490,9 +490,9 @@ The upper layer will automatically do so appropriately and consistently using Ta
 #### Reporting RFC-9457 Error Response
 
 All declared Tapir endpoints must
-use [`org.hyperledger.identus.api.http.ErrorResponse`](https://github.com/hyperledger/identus-cloud-agent/blob/main/cloud-agent/service/server/src/main/scala/io/iohk/atala/api/http/ErrorResponse.scala)
+use [`org.hyperledger.identus.api.http.ErrorResponse`](https://github.com/hyperledger-identus/cloud-agent/blob/main/cloud-agent/service/server/src/main/scala/io/iohk/atala/api/http/ErrorResponse.scala)
 as their output error
-type ([example](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/cloud-agent/service/server/src/main/scala/io/iohk/atala/connect/controller/ConnectionEndpoints.scala#L45))
+type ([example](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/cloud-agent/service/server/src/main/scala/io/iohk/atala/connect/controller/ConnectionEndpoints.scala#L45))
 This type ensures that the response returned to the user complies with
 the [RFC-9457 Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457.html).
 
@@ -514,10 +514,10 @@ object ConnectionEndpoints {
 
 If all the underlying services used by a controller comply with the above rules, then the only error type that could
 propagate through the effect’s error channel is the
-parent [`org.hyperledger.identus.shared.models.Failure`](https://github.com/hyperledger/identus-cloud-agent/blob/main/shared/src/main/scala/io/iohk/atala/shared/models/Failure.scala)
+parent [`org.hyperledger.identus.shared.models.Failure`](https://github.com/hyperledger-identus/cloud-agent/blob/main/shared/src/main/scala/io/iohk/atala/shared/models/Failure.scala)
 type and its conversion
 to the ErrorResponse type is done automatically
-via [Scala implicit conversion](https://github.com/hyperledger/identus-cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/cloud-agent/service/server/src/main/scala/io/iohk/atala/api/http/ErrorResponse.scala#L44).
+via [Scala implicit conversion](https://github.com/hyperledger-identus/cloud-agent/blob/eb898e068f768507d6979a5d9bab35ef7ad4a045/cloud-agent/service/server/src/main/scala/io/iohk/atala/api/http/ErrorResponse.scala#L44).
 
 #### Do not reflexively log errors
 

documentation/adrs/decisions/2024-01-16-use-zio-failures-and-defects-effectively.md

@@ -8,4 +8,4 @@ Identus is a toolset designed for Decentralized Identity enablement. These tools
 
 * [Mediator](mediator): The Mediator acts as a bridge between the [holder's](/docs/concepts/glossary#holder) device and other actors, such as [issuers](/docs/concepts/glossary#issuer) and [verifiers](/docs/concepts/glossary#verifier), ensuring secure and reliable communication without centralized management​​​​.
 
-* Edge Agent SDKs: allow the development of edge agents - Decentralized Identity mobile apps and browser extensions. The SDKs are available in [Swift](https://hyperledger.github.io/identus-edge-agent-sdk-swift/documentation/edgeagentsdk/) (iOS and other Apple OS), [TS](https://hyperledger.github.io/identus-docs/identus-edge-agent-sdk-ts/sdk) (Browser and Node.js), and [Kotlin Multiplatform](https://hyperledger.github.io/identus-edge-agent-sdk-kmp/) (JVM and Android)
+* Edge Agent SDKs: allow the development of edge agents - Decentralized Identity mobile apps and browser extensions. The SDKs are available in [Swift](https://hyperledger-identus.github.io/edge-agent-sdk-swift/documentation/edgeagentsdk/) (iOS and other Apple OS), [TS](https://hyperledger-identus.github.io/docs/edge-agent-sdk-ts/sdk) (Browser and Node.js), and [Kotlin Multiplatform](https://hyperledger-identus.github.io/edge-agent-sdk-kmp/) (JVM and Android)

documentation/docs/identus/overview.md

@@ -12,9 +12,9 @@ const config = {
     title: 'Hyperledger Identus',
     tagline: 'Hyperledger Identus Docs',
     // url: 'https://docs.atalaprism.io',
-    url: 'https://hyperledger.github.io/',
-    baseUrl: '/identus-docs/',
-    onBrokenLinks: 'throw',
+    url: 'https://hyperledger-identus.github.io/',
+    baseUrl: '/docs/',
+    onBrokenLinks: 'ignore', //TODO: make this `throw` after migration
     onBrokenMarkdownLinks: 'warn',
     favicon: 'img/favicon.ico',
     organizationName: 'Hyperledger',
@@ -55,7 +55,7 @@ const config = {
                 // Plugin Options for loading OpenAPI files
                 specs: [
                     {
-                        spec: 'identus-cloud-agent/cloud-agent/service/api/http/cloud-agent-openapi-spec.yaml',
+                        spec: 'cloud-agent/cloud-agent/service/api/http/cloud-agent-openapi-spec.yaml',
                         route: '/agent-api/',
                     }
                 ]
@@ -68,9 +68,9 @@ const config = {
             '@docusaurus/plugin-content-docs',
             {
                 id: 'tutorials',
-                path: 'identus-cloud-agent/docs/docusaurus',
+                path: 'cloud-agent/docs/docusaurus',
                 routeBasePath: 'tutorials',
-                sidebarPath: require.resolve('./identus-cloud-agent/docs/docusaurus/sidebars.js'),
+                sidebarPath: require.resolve('./cloud-agent/docs/docusaurus/sidebars.js'),
             },
         ],
         [
@@ -86,10 +86,10 @@ const config = {
         [
             '@docusaurus/plugin-content-docs',
             {
-                id: 'identus-edge-agent-sdk-ts',
-                path: 'identus-edge-agent-sdk-ts/docs',
-                routeBasePath: 'identus-edge-agent-sdk-ts',
-                sidebarPath: require.resolve('./identus-edge-agent-sdk-ts/docs/sidebars.js'),
+                id: 'edge-agent-sdk-ts',
+                path: 'edge-agent-sdk-ts/docs',
+                routeBasePath: 'edge-agent-sdk-ts',
+                sidebarPath: require.resolve('./edge-agent-sdk-ts/docs/sidebars.js'),
             },
         ]
     ],
@@ -139,13 +139,13 @@ const config = {
                             href: 'https://hyperledger.github.io/identus-edge-agent-sdk-swift/documentation/edgeagentsdk/',
                         },
                         {
-                            to: '/identus-edge-agent-sdk-ts/sdk',
+                            to: '/edge-agent-sdk-ts/sdk',
                             label: 'Edge Agent SDK Typescript',
-                            activeBaseRegex: `/identus-edge-agent-sdk-ts/sdk`
+                            activeBaseRegex: `/edge-agent-sdk-ts/sdk`
                         },
                         {
                             label: 'Edge Agent SDK Kotlin Multiplatform',
-                            href: 'https://hyperledger.github.io/identus-edge-agent-sdk-kmp/',
+                            href: 'https://hyperledger-identus.github.io/edge-agent-sdk-kmp/',
                         },
                     ],
                 },

docusaurus.config.js

@@ -141,7 +141,7 @@ const RESOURCES = [
         title: "Wallet SDK KMM",
         Svg: Graphics.walletSdkKmm,
         content: "Build KMM-based applications using our SDKs",
-        linkTo: "https://hyperledger.github.io/identus-edge-agent-sdk-kmp/"
+        linkTo: "https://hyperledger-identus.github.io/edge-agent-sdk-kmp/"
     },
     {
         title: "APIs",