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
48 changes: 48 additions & 0 deletions ARCHITECTURE.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
== Architecture

=== Overview

This repository follows a modular, maintainable architecture designed
for clarity, scalability, and long-term sustainability.

=== Directory Structure

....
.
├── src/ # Source code
├── tests/ # Test suites
├── docs/ # Documentation
├── scripts/ # Utility scripts
├── config/ # Configuration files
├── LICENSE # License file
├── LICENSES/ # Full license texts
└── README.adoc # Project documentation
....

=== Design Principles

* *Separation of Concerns*: Each module has a single responsibility
* *Testability*: Code is written to be easily testable
* *Documentation*: All public APIs are documented
* *Configuration*: Environment-specific settings are externalized

=== Dependencies

* External dependencies are minimized and clearly declared
* Version pinning is used for reproducibility

=== Security Considerations

* Sensitive data is never committed to the repository
* Secrets are managed through environment variables or secure vaults
* Regular dependency audits are performed

=== Maintainability

* Code follows consistent style guidelines
* Pull requests require review and CI checks
* Issues and discussions are tracked transparently

'''''

_Last updated: 2026-07-18_
47 changes: 0 additions & 47 deletions ARCHITECTURE.md

This file was deleted.

130 changes: 68 additions & 62 deletions CHANGELOG.adoc
Original file line number Diff line number Diff line change
@@ -1,69 +1,75 @@
// SPDX-License-Identifier: CC-BY-SA-4.0
// SPDX-FileCopyrightText: 2025 Laminar Contributors
== Changelog

All notable changes to `+laminar+` will be documented in this file.

This file is generated from conventional commits by the
https://github.com/hyperpolymath/standards/blob/main/.github/workflows/changelog-reusable.yml[`+changelog-reusable.yml+`]
workflow (`+hyperpolymath/standards#206+`). Adopt the workflow in this
repo’s CI to keep this file in sync automatically — see
https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+templates/cliff.toml+`]
for the canonical config.

The format follows https://keepachangelog.com/en/1.1.0/[Keep a
Changelog]; this project aims to follow
https://semver.org/spec/v2.0.0.html[Semantic Versioning].

=== [Unreleased]

==== Added

* feat(crg): add crg-grade and crg-badge justfile recipes
* feat: add stapeln.toml container definition
* feat: deploy UX Manifesto infrastructure
* feat: add Idris2 ABI, Zig FFI, and V-lang API
* feat: add Groove discovery manifest
* feat: update CLI, rclone client, and mix config
* feat: add CLADE.a2ml — clade taxonomy declaration
* feat: add AI Gatekeeper Protocol manifest
* feat(ci): enable Hypatia scanning

==== Fixed

* fix(ci): bump a2ml/k9-validate-action pins to canonical (#24)
* fix(ci): sync hypatia-scan.yml to canonical (#23)
* fix(ci): adopt canonical hypatia-scan.yml (#22)
* fix(ci): Phase-2 fleet submission must not fail the security gate
(#21)
* fix(scorecard): enforce granular permissions and add fuzzing
placeholder
* fix(ci): Resolve workflow-linter self-matching and metadata issues
* fix: remove duplicate SCM files from root
* fix(security): ERR-WF-008 and ERR-WF-009 fixes
* fix: correct author name in CITATION.cff
* fix: align CodeQL with repo languages (robot-cleaner)

==== Changed

* refactor: migrate 6SCM → 6A2 (.scm → .a2ml format)

= Changelog
:toc:

All notable changes to Laminar will be documented in this file.

The format is based on https://keepachangelog.com/en/1.1.0/[Keep a Changelog],
and this project adheres to https://semver.org/spec/v2.0.0.html[Semantic Versioning].

== [Unreleased]

=== Added
- Placeholder for upcoming features

== [1.0.0] - 2025-11-27

=== Added
==== Documentation

==== Core Features
- Cloud-to-cloud streaming relay architecture
- Zero-persistence data transfer (RAM + NVMe caching)
- Parallel streaming with 32+ concurrent transfers
- Multi-thread streams for large files (BitTorrent-style logic)
* docs: substantive CRG C annotation (EXPLAINME.adoc)
* docs: add TEST-NEEDS.md and/or PROOF-NEEDS.md from audit
* docs: add EXPLAINME.adoc — prove-it file backing README claims
* docs: add CONTRIBUTING.md
* docs: add checkpoint files for state tracking

==== Intelligence Engine
- Pattern-matching rule system for file decisions
- Automatic filtering of build artifacts (node_modules, _build, target)
- OS junk removal (.DS_Store, Thumbs.db)
- Ghost Links for files > 5GB
- Format conversion support (WAV→FLAC, BMP→WebP)
- Compression for large text files (Zstd)
==== CI

==== Control Plane (Elixir)
- GraphQL API with Absinthe
- Real-time subscriptions for transfer progress
- REST API fallback endpoints
- Broadway-based 4-lane processing pipeline
* ci: redistribute concurrency-cancel guard to read-only check workflows
(#26)
* ci: bump actions/upload-artifact SHA to current v4 (#19)
* ci: SHA-pin hyperpolymath validate-actions in dogfood-gate
* ci: wire hypatia-scan.yml to query own Dependabot alerts
* ci: deploy dogfood-gate, add CRG tests and Groove manifest, update CI
config

==== Data Plane (Rclone)
- Integration with 40+ cloud providers
- Rclone RC API client
- Checksum verification
- Resume capability via checkpoint caching
=== Pre-history

==== Infrastructure
- Podman containers with Chainguard Wolfi base
- Network physics optimization (TCP BBR, GRO/LRO tuning)
- Tiered storage (RAM Tier 1, NVMe Tier 2)
- Oil Shell installer script
Prior commits to this file’s introduction are recorded in git history
but not formally classified into Keep-a-Changelog sections. To backfill,
run `+git cliff -o CHANGELOG.md+` locally using the canonical
https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+cliff.toml+`]
— this is one-shot mechanical work.

==== Documentation
- Comprehensive wiki with user and developer guides
- AsciiDoc format throughout
- CLAUDE.adoc for AI-assisted development
- Cookbook with tuning recipes

=== Security
- Non-root container execution
- Credentials never in container images
- TLS for all cloud connections
- eDNS for CDN optimization

== [0.1.0] - 2025-11-27

=== Added
- Initial project structure
- Proof of concept implementation
'''''
72 changes: 0 additions & 72 deletions CHANGELOG.md

This file was deleted.

24 changes: 24 additions & 0 deletions CODE_OF_CONDUCT.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
== Contributor Covenant Code of Conduct

=== Our Pledge

We pledge to make participation a harassment-free experience for
everyone.

=== Our Standards

*Positive behavior:* * Using welcoming language * Being respectful of
differing viewpoints * Accepting constructive criticism * Focusing on
what is best for the community

*Unacceptable behavior:* * Harassment, trolling, or personal attacks *
Publishing private information without permission

=== Enforcement

Report issues to the maintainers. All complaints will be reviewed.

=== Attribution

Adapted from https://www.contributor-covenant.org/[Contributor Covenant]
v2.1.
27 changes: 0 additions & 27 deletions CODE_OF_CONDUCT.md

This file was deleted.

Loading
Loading