arc-cloud 0.1.0__tar.gz

arc_cloud-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+*"
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Release destination"
+        required: true
+        default: "testpypi"
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build sdist and wheel
+        run: |
+          python -m build
+
+      - name: Check package integrity
+        run: |
+          python -m twine check dist/*
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: [build]
+    if: github.event.inputs.target == 'testpypi' || startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/arc-cloud
+    permissions:
+      id-token: write  # Mandatory for Trusted Publishing
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to TestPyPI via PyPI Publish Action
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  publish-pypi:
+    name: Publish to Production PyPI
+    needs: [build, publish-testpypi]
+    if: github.event.inputs.target == 'pypi' || (startsWith(github.ref, 'refs/tags/v') && !contains(github.ref, '-rc') && !contains(github.ref, '-alpha'))
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/arc-cloud
+    permissions:
+      id-token: write  # Mandatory for Trusted Publishing
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

arc_cloud-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,43 @@
+name: Tests & CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run pytest
+        run: |
+          pytest -v --cov=arc_cloud --cov-report=term-missing
+
+      - name: Build distribution packages
+        run: |
+          python -m build
+
+      - name: Verify distribution archives
+        run: |
+          python -m twine check dist/*

arc_cloud-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Virtual Environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Editor directories
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Temporary outputs
+blueprint.json
+scan_results.json
+target/

arc_cloud-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

arc_cloud-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-09-04
+
+Initial public release of ARC CLOUD CLI.
+
+- **Local Software X-Ray Scanning**: Deterministic static analysis without executing project code or requiring an LLM/cloud account.
+- **Language Detection**: Extension- and manifest-based detection for Dart, Python, JavaScript, TypeScript, Java, Kotlin, Swift, C#, C++, Go, Rust, PHP, and Ruby with file counts and percentage metrics.
+- **Modular Framework Detectors**: Independent detectors for Flutter, React, Next.js, Node.js, FastAPI, Django, Spring Boot, and .NET.
+- **Target Platform Detection**: Automated detection for Android, iOS, Web, Windows, macOS, and Linux.
+- **Safe Dependency Extraction**: Static parsing for `pubspec.yaml`, `package.json`, `requirements.txt`, `pyproject.toml`, `Pipfile`, `pom.xml`, `build.gradle`, and `*.csproj`.
+- **Configuration & Structure Analysis**: Categorizes directories into source, tests, assets, platforms, configuration, and documentation; catalogs key project manifests.
+- **Software Blueprint Schema v1.0**: Validated Pydantic models with schema versioning.
+- **Rich Terminal UI**: Polished terminal presentation powered by Rich.
+- **Flexible Output Modes**: Raw JSON output (`arc scan --json`) and direct file export (`arc scan --output blueprint.json`).
+- **Security & Limits**: Hardened path traversal protection, symlink escape isolation, sensitive/`.env` file blocking, and safe traversal limits.
+- **Global Executable**: Installs globally as `arc` via `pipx` or standard `pip`.

arc_cloud-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARC CLOUD
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

arc_cloud-0.1.0/PKG-INFO

@@ -0,0 +1,303 @@
+Metadata-Version: 2.5
+Name: arc-cloud
+Version: 0.1.0
+Summary: ARC CLOUD Software X-Ray CLI
+Project-URL: Homepage, https://github.com/arc-cloud-innovations/arc-cloud-cli
+Project-URL: Documentation, https://github.com/arc-cloud-innovations/arc-cloud-cli#readme
+Project-URL: Repository, https://github.com/arc-cloud-innovations/arc-cloud-cli
+Project-URL: Issues, https://github.com/arc-cloud-innovations/arc-cloud-cli/issues
+Author-email: ARC CLOUD Team <support@arc-cloud.dev>
+License: MIT
+License-File: LICENSE
+Keywords: architecture,cli,developer-tools,project-scanner,software-blueprint,static-analysis,x-ray
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: build>=1.1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ARC CLOUD CLI
+
+[![CI Tests](https://github.com/arc-cloud-innovations/arc-cloud-cli/actions/workflows/tests.yml/badge.svg)](https://github.com/arc-cloud-innovations/arc-cloud-cli/actions/workflows/tests.yml)
+[![PyPI version](https://img.shields.io/pypi/v/arc-cloud.svg)](https://pypi.org/project/arc-cloud/)
+[![Python Version](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+
+> **ARC CLOUD CLI** is a local Software X-Ray tool that analyzes a software project and generates a structured Software Blueprint containing detected languages, frameworks, platforms, dependencies, configuration and project structure.
+
+---
+
+## Privacy & Security Guarantee
+
+```text
+ARC CLOUD CLI performs project scanning locally.
+Your source code is not uploaded to ARC CLOUD during local scanning.
+```
+
+- **100% Offline & Local**: Scanning runs entirely on your local machine without sending your code to any cloud server or LLM API.
+- **Zero Code Execution**: Manifests and code files are statically inspected. The scanner never executes project code or runs package managers (`npm install`, `pip install`, `flutter pub get`, `gradle`, `cargo`, etc.).
+- **Secret Protection**: Files matching `.env`, `.env.*`, `credentials.json`, `id_rsa`, `*.key`, and secret patterns are never read, printed, or exported.
+- **No AI / LLM Requirement**: Deterministic, rule-based static analysis engine.
+
+---
+
+## Installation
+
+### Recommended: `pipx` (Globally Available)
+Install once globally and run from any project directory:
+```bash
+pipx install arc-cloud
+```
+
+### Standard `pip`
+```bash
+pip install arc-cloud
+```
+
+### Development Installation
+```bash
+git clone https://github.com/arc-cloud-innovations/arc-cloud-cli.git
+cd arc-cloud-cli
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+---
+
+## Usage
+
+### 1. Scan Current Project Directory
+Navigate to any project on your computer and run:
+```bash
+cd my-project
+arc scan
+```
+
+### 2. Scan a Specific Project Path
+```bash
+arc scan ./my-project
+arc scan /absolute/path/to/project
+```
+
+### 3. Output as Raw JSON
+Stream the normalized Software Blueprint JSON directly to stdout for scripting or piping into `jq`:
+```bash
+arc scan --json
+arc scan ./my-project --json | jq .project
+```
+
+### 4. Export Blueprint to File
+```bash
+arc scan --output blueprint.json
+```
+
+### 5. Check CLI Version & Help
+```bash
+arc --version
+arc --help
+```
+
+---
+
+## Supported Technologies
+
+### Programming Languages
+- **Dart** (`.dart`)
+- **Python** (`.py`, `.pyi`, `.pyw`)
+- **JavaScript** (`.js`, `.mjs`, `.cjs`, `.jsx`)
+- **TypeScript** (`.ts`, `.mts`, `.cts`, `.tsx`)
+- **Java** (`.java`)
+- **Kotlin** (`.kt`, `.kts`)
+- **Swift** (`.swift`)
+- **C#** (`.cs`, `.csx`)
+- **C++ / C** (`.cpp`, `.cc`, `.cxx`, `.hpp`, `.h`, `.c`)
+- **Go** (`.go`)
+- **Rust** (`.rs`)
+- **PHP** (`.php`)
+- **Ruby** (`.rb`)
+
+### Frameworks & Ecosystems
+- **Flutter**: `pubspec.yaml`, Flutter SDK dependencies, Dart files, Android/iOS directories.
+- **React**: `package.json`, `react` dependencies, JSX/TSX components.
+- **Next.js**: `package.json`, `next` dependencies, `next.config.*`, App/Pages router.
+- **Node.js**: `package.json`, JavaScript/TypeScript server signals.
+- **FastAPI**: `requirements.txt`, `pyproject.toml`, `fastapi` dependencies.
+- **Django**: `requirements.txt`, `manage.py`, `django` dependencies.
+- **Spring Boot**: `pom.xml`, `build.gradle`, Spring starter dependencies.
+- **.NET**: `*.csproj`, `*.sln`, SDK indicators.
+
+### Platforms Detected
+- **Android**, **iOS**, **Web**, **Windows**, **macOS**, **Linux**
+
+### Project Classifications
+- **Mobile Application**, **Web Application**, **Backend**, **Full Stack**, **Desktop Application**, **Library**, **CLI Application**, **Unknown**
+
+---
+
+## CLI Commands Reference
+
+| Command | Description |
+| :--- | :--- |
+| `arc scan [PATH]` | Perform static project analysis and generate Software Blueprint (defaults to current directory) |
+| `arc --version` | Display the installed CLI version |
+| `arc --help` | Display general help and command options |
+
+Options for `arc scan`:
+- `--json`, `-j`: Output the normalized Software Blueprint as raw JSON to stdout.
+- `--output`, `-o <FILE>`: Save the normalized Software Blueprint JSON to a specified file.
+- `--max-files <INT>`: Maximum number of files to inspect (default: 20,000).
+- `--max-depth <INT>`: Maximum directory recursion depth (default: 20).
+
+---
+
+## Software Blueprint JSON Specification
+
+The Software Blueprint uses schema version `1.0`:
+
+```json
+{
+  "schema_version": "1.0",
+  "scanner": {
+    "name": "ARC CLOUD CLI",
+    "version": "0.1.0",
+    "timestamp": "2026-09-04T12:00:00Z",
+    "duration_seconds": 0.04,
+    "files_scanned": 128
+  },
+  "project": {
+    "name": "my_project",
+    "type": "Mobile Application",
+    "root_path": "/path/to/my_project",
+    "description": null
+  },
+  "languages": [
+    {
+      "name": "Dart",
+      "files": 45,
+      "percentage": 88.2
+    }
+  ],
+  "frameworks": [
+    {
+      "name": "Flutter",
+      "version": "3.19.0",
+      "category": "Mobile",
+      "confidence": 1.0
+    }
+  ],
+  "platforms": [
+    {
+      "name": "Android",
+      "source": "android/ directory"
+    },
+    {
+      "name": "iOS",
+      "source": "ios/ directory"
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "cupertino_icons",
+      "version": "^1.0.6",
+      "source": "pubspec.yaml",
+      "type": "runtime"
+    }
+  ],
+  "configuration_files": [
+    {
+      "path": "pubspec.yaml",
+      "name": "pubspec.yaml",
+      "type": "package"
+    }
+  ],
+  "structure": {
+    "areas": [
+      {
+        "name": "source",
+        "paths": ["lib"]
+      },
+      {
+        "name": "tests",
+        "paths": ["test"]
+      }
+    ],
+    "total_files": 128,
+    "total_directories": 14,
+    "ignored_directories": [".git", ".dart_tool"]
+  },
+  "architecture": {
+    "patterns": ["Layered / Modular Architecture"],
+    "details": {
+      "test_suite_detected": true
+    }
+  },
+  "warnings": []
+}
+```
+
+---
+
+## Development & Testing
+
+Run all tests:
+```bash
+pytest -v
+```
+
+Run test coverage:
+```bash
+pytest --cov=arc_cloud --cov-report=term-missing
+```
+
+Build the distribution packages:
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+---
+
+## Release Process
+
+### 1. TestPyPI Publishing
+```bash
+twine upload -r testpypi dist/*
+```
+Verify the TestPyPI package:
+```bash
+pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ arc-cloud
+arc --version
+```
+
+### 2. Production PyPI Publishing
+When authorized by the project owner:
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+GitHub Actions will run tests, build distribution wheels, and publish to production PyPI via PyPI Trusted Publishing.
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.