{"id":46627403,"url":"https://github.com/morzecrew/forze","last_synced_at":"2026-04-08T04:02:18.099Z","repository":{"id":342853875,"uuid":"1164222781","full_name":"morzecrew/forze","owner":"morzecrew","description":"Domain-Driven Design and Hexagonal Architecture for backend services","archived":false,"fork":false,"pushed_at":"2026-04-03T21:43:48.000Z","size":3292,"stargazers_count":0,"open_issues_count":6,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T23:25:07.962Z","etag":null,"topics":["architecture","ddd","domain-driven-design","framework","hexagonal","hexagonal-architecture","kernel"],"latest_commit_sha":null,"homepage":"https://morzecrew.github.io/forze/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/morzecrew.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-22T20:19:37.000Z","updated_at":"2026-03-23T18:58:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/morzecrew/forze","commit_stats":null,"previous_names":["morzecrew/forze"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/morzecrew/forze","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzecrew%2Fforze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzecrew%2Fforze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzecrew%2Fforze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzecrew%2Fforze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/morzecrew","download_url":"https://codeload.github.com/morzecrew/forze/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/morzecrew%2Fforze/sbom","scorecard":{"id":1245563,"data":{"date":"2026-03-30T05:19:51Z","repo":{"name":"github.com/morzecrew/forze","commit":"c9e9e5cee51c1ccbbd90957c05e7d10e3be29f5a"},"scorecard":{"version":"v5.3.0","commit":"c22063e786c11f9dd714d777a687ff7c4599b600"},"score":7.3,"checks":[{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dependency-update-tool"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#security-policy"}},{"name":"Code-Review","score":0,"reason":"Found 0/23 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"project was created within the last 90 days. Please review its contents carefully","details":["Warn: Repository was created within the last 90 days."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":8,"reason":"dependency not pinned by hash detected -- score normalized to 8","details":["Warn: downloadThenRun not pinned by hash: .devcontainer/Dockerfile:16-18","Warn: downloadThenRun not pinned by hash: .devcontainer/Dockerfile:16-18","Warn: downloadThenRun not pinned by hash: .devcontainer/Dockerfile:16-18","Warn: downloadThenRun not pinned by hash: .github/workflows/pages.yaml:45","Info:  20 out of  20 GitHub-owned GitHubAction dependencies pinned","Info:  26 out of  26 third-party GitHubAction dependencies pinned","Info:   0 out of   4 downloadThenRun dependencies pinned","Info:   1 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:38","Info: jobLevel 'pull-requests' permission set to 'read': .github/workflows/ci.yml:39","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:83","Warn: jobLevel 'checks' permission set to 'write': .github/workflows/ci.yml:120","Info: jobLevel 'contents' permission set to 'read': .github/workflows/ci.yml:119","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:33","Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql.yml:32","Info: jobLevel 'contents' permission set to 'read': .github/workflows/release.yaml:84","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/release.yaml:107","Info: jobLevel 'contents' permission set to 'read': .github/workflows/release.yaml:18","Warn: jobLevel 'checks' permission set to 'write': .github/workflows/release.yaml:19","Info: jobLevel 'contents' permission set to 'read': .github/workflows/release.yaml:28","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:31","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql.yml:26","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/release.yaml:9","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yaml:8"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#token-permissions"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#vulnerabilities"}},{"name":"CII-Best-Practices","score":5,"reason":"badge detected: Passing","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#cii-best-practices"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#signed-releases"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#fuzzing"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/release.yaml:76"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#branch-protection"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: SAST configuration detected: CodeQL","Info: all commits (8) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#sast"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#license"}},{"name":"CI-Tests","score":10,"reason":"8 out of 8 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#ci-tests"}},{"name":"Contributors","score":3,"reason":"project has 1 contributing companies or organizations -- score normalized to 3","details":["Info: found contributions from: dakko-group"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/c22063e786c11f9dd714d777a687ff7c4599b600/docs/checks.md#contributors"}}]},"last_synced_at":"2026-04-03T23:25:11.446Z","repository_id":342853875,"created_at":"2026-04-03T23:25:11.447Z","updated_at":"2026-04-03T23:25:11.447Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31539229,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture","ddd","domain-driven-design","framework","hexagonal","hexagonal-architecture","kernel"],"created_at":"2026-03-07T23:03:28.196Z","updated_at":"2026-04-08T04:02:18.093Z","avatar_url":"https://github.com/morzecrew.png","language":"Python","readme":"# Forze\n\n[![PyPI](https://img.shields.io/pypi/v/forze?label=PyPI)](https://pypi.org/project/forze/)\n[![Python](https://img.shields.io/pypi/pyversions/forze)](https://pypi.org/project/forze/)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/morzecrew/forze/badge)](https://scorecard.dev/viewer/?uri=github.com/morzecrew/forze)\n[![CodeFactor](https://www.codefactor.io/repository/github/morzecrew/forze/badge)](https://www.codefactor.io/repository/github/morzecrew/forze)\n[![codecov](https://codecov.io/github/morzecrew/forze/graph/badge.svg?token=WIKAC2IUS9)](https://codecov.io/github/morzecrew/forze)\n\n**Forze** is a lightweight infrastructure toolkit for building backend services\nwith Domain-Driven Design and Hexagonal Architecture.\n\nIt provides a set of reusable primitives, contracts, and structural patterns\nthat help organize backend applications into clear, maintainable layers.\n\n## Design Goals\n\nForze aims to support backend systems that are:\n\n- **Layered** — clear separation between domain, application, and infrastructure\n- **Explicit** — well-defined ports, adapters, and boundaries\n- **Testable** — components can be tested in isolation\n- **Composable** — infrastructure pieces can be replaced or extended\n- **Framework-agnostic** — the core does not depend on a specific framework\n\nThe library focuses on providing **structure and contracts**, not a full-stack framework.\n\n## Quick Start\n\nInstall the core package:\n\n```bash\nuv add forze\n```\n\nInstall with optional integrations:\n\n```bash\nuv add 'forze[fastapi,postgres,socketio]'\n```\n\n## Documentation\n\nFull documentation is available at [https://morzecrew.github.io/forze/](https://morzecrew.github.io/forze/).\n\n## Agent Skills\n\nForze ships with AI agent skills that help assistants understand the framework's architecture, patterns, and conventions. Install them to improve code generation and refactoring when working with Forze.\n\nSkills follow the [Agent Skills](https://agentskills.io/) format.\n\n### Installation\n\n```bash\n# Install all skills\nnpx skills add morzecrew/forze\n\n# Install a specific skill\nnpx skills add morzecrew/forze@forze-wiring\n```\n\n### Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected.\n\n### Available Skills\n\n| Name | Description |\n| -------- | -------- |\n|**forze-framework-usage** | Write code that uses the framework correctly according to the core concepts. |\n|**forze-domain-aggregates** | Define domain models, document aggregates, and specifications. |\n|**forze-wiring** | Wire runtime, dependencies, lifecycle, usecase composition, and interface layer. |\n\n## Versioning\n\nForze follows [Semantic Versioning (SemVer)](https://semver.org/).\nPre-release builds may include experimental APIs and are not guaranteed to be stable.\n\n## Contributing\n\nContributions, issues, and feature requests are welcome.\nSee [CONTRIBUTING.md](https://github.com/morzecrew/forze/blob/main/CONTRIBUTING.md) for details.\n\n## Security\n\nPlease report security vulnerabilities privately as described in [SECURITY.md](https://github.com/morzecrew/forze/blob/main/SECURITY.md).\n\n## License\n\nForze is licensed under the MIT License - see [LICENSE](https://github.com/morzecrew/forze/blob/main/LICENSE) for details.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorzecrew%2Fforze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmorzecrew%2Fforze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmorzecrew%2Fforze/lists"}