Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Copyright (c) 2026 Samsarix LLC
# SPDX-License-Identifier: MPL-2.0

# Require review from the repository owner for every path by default.
* @Deathcharge
16 changes: 16 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Copyright (c) 2026 Samsarix LLC
# SPDX-License-Identifier: MPL-2.0

version: 2
updates:
- package-ecosystem: pip
directory: /
schedule:
interval: monthly
open-pull-requests-limit: 5

- package-ecosystem: github-actions
directory: /
schedule:
interval: monthly
open-pull-requests-limit: 5
94 changes: 94 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# Copyright (c) 2026 Samsarix LLC
# SPDX-License-Identifier: MPL-2.0

name: CI

on:
push:
pull_request:
workflow_dispatch:

permissions:
contents: read

concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true

jobs:
test:
name: Test (${{ matrix.os }}, Python ${{ matrix.python }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, windows-latest]
python: ["3.11", "3.14"]

steps:
- name: Check out repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version: ${{ matrix.python }}

- name: Install package
run: python -m pip install --disable-pip-version-check .

- name: Run unit and command tests
run: python -m unittest discover -s tests -v

- name: Run strict repository readiness check
run: samsarix-platform doctor samsarix-stack.toml --strict

- name: Verify JSON readiness output
run: samsarix-platform doctor samsarix-stack.toml --json --strict

quality:
name: Quality and package
runs-on: ubuntu-latest

steps:
- name: Check out repository
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1

- name: Set up Python
uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
with:
python-version: "3.14"

- name: Install package and pinned development tools
run: |
python -m pip install --disable-pip-version-check -e .
python -m pip install --disable-pip-version-check -r requirements-dev.txt

- name: Check formatting
run: python -m ruff format --check .

- name: Lint
run: python -m ruff check .

- name: Type check
run: python -m mypy src tests

- name: Test with branch coverage
run: |
python -m coverage erase
python -m coverage run -m unittest discover -s tests
python -m coverage report

- name: Build distributions
run: python -m build

- name: Check distribution metadata
run: python -m twine check dist/*

- name: Reinstall and smoke-test the wheel
run: |
python -m pip install --disable-pip-version-check --force-reinstall dist/*.whl
samsarix-platform --version
samsarix-platform doctor samsarix-stack.toml --strict
python -m samsarix_platform --version
python -m pip check
13 changes: 13 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
.coverage
.env
.mypy_cache/
.pytest_cache/
.ruff_cache/
.venv/
__pycache__/
build/
dist/
htmlcov/
*.egg-info/
*.py[cod]

25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Changelog

All notable changes to Samsarix Platform Doctor are documented here.

## Unreleased

### Added

- Local `doctor` command with human and JSON output.
- Non-overwriting `init` command and versioned TOML manifest.
- Python, installed-distribution, environment-presence, and contained-file checks.
- Strict validation, a 1 MiB input limit, terminal-control rejection, stable exit codes, secret-value redaction, read-path containment, and destination-symlink protection.
- Unit, CLI, installed-package, example, coverage, lint, type, build, and cross-platform CI checks.
- MPL 2.0 licensing, Samsarix LLC copyright attribution, brand notices, and private support/security contacts.

### Changed

- Reframed the repository from an unimplemented multi-agent platform into an independent readiness CLI.
- Renamed the pre-release distribution, import package, command, manifest, and JSON schema from Helix to Samsarix.
- Replaced speculative architecture, deployment, performance, security, community, and license claims with verified documentation.

### Removed

- Uninstallable dependencies on unpublished Helix distributions.
- Obsolete backup documentation and fabricated cloud/container deployment instructions.
69 changes: 18 additions & 51 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,27 @@
# Code of Conduct
# Code of conduct

## Our Commitment
## Our commitment

We are committed to providing a welcoming, inclusive, and harassment-free community for everyone. We value the participation of each member and want all contributors to have a positive experience.
Project spaces should be welcoming, professional, and free from harassment. Participants are expected to communicate respectfully, assume good faith while evaluating evidence, and make room for people with different backgrounds and experience levels.

## Expected Behavior
## Expected behavior

We expect all community members to:
- Be respectful, specific, and constructive.
- Focus criticism on ideas, code, and observable behavior.
- Protect private information and credentials.
- Accept corrections and resolve disagreements with evidence.
- Respect project scope, maintainer decisions, and community boundaries.

- **Be respectful** - Treat others with kindness and respect
- **Be inclusive** - Welcome people of all backgrounds and experience levels
- **Be constructive** - Provide helpful feedback and support
- **Be professional** - Keep discussions focused and productive
- **Be honest** - Act with integrity and transparency
## Unacceptable behavior

## Unacceptable Behavior
- Harassment, discrimination, threats, or personal attacks.
- Sexualized language or unwelcome attention.
- Publishing another person's private information without permission.
- Deliberate disruption, impersonation, or repeated bad-faith engagement.
- Pressuring anyone to disclose credentials or nonpublic security details.

The following behaviors are not tolerated:
## Scope and enforcement

- Harassment, discrimination, or bullying
- Offensive language or personal attacks
- Unwelcome sexual attention or advances
- Sharing others' private information without consent
- Disruptive or trolling behavior
- Any form of intimidation or threats
This code applies in repository issues, pull requests, discussions, and other official project spaces. Maintainers may edit or remove contributions, restrict participation, or ban participants when necessary to protect the community.

## Reporting Issues

If you experience or witness unacceptable behavior:

1. **Document** the incident (date, time, people involved, description)
2. **Report** to the maintainers at conduct@helix-platform.ai
3. **Include** any relevant context or evidence
4. **Remain** confidential and respectful

## Enforcement

Violations of this code of conduct may result in:

- Warning or temporary suspension
- Removal from the community
- Permanent ban from the project

## Scope

This code of conduct applies to:
- GitHub repositories and issues
- Pull request discussions
- Community forums and chat
- Official events and meetings
- Any official project communication

## Questions?

If you have questions about this code of conduct, please contact the maintainers.

---

**We are committed to fostering an inclusive and welcoming community.** 🌍
Use GitHub's report/block controls for urgent platform abuse. Report project conduct concerns privately to [support@samsarix.com](mailto:support@samsarix.com) with the subject `Conduct: Samsarix Platform Doctor`. Do not disclose secrets or sensitive personal information in a public issue.
Loading
Loading