@datamitsu/datamitsu-linux-x64 0.0.1-alpha-1

package/README.md

@@ -0,0 +1,188 @@
+# datamitsu
+
+> Opinionated configuration management, extensible by design
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Philosophy & Name
+
+**Datamitsu** combines "data" with "mitsu" (光 - light, 蜜 - honey in Japanese), symbolizing clarity and sweetness in managing development tools and configurations.
+
+The name reflects the project's philosophy: to bring **clarity** to the complexity of tool management and **sweetness** to the developer experience through a stable, fast core engine that others can extend with opinionated configurations.
+
+Like light illuminating the path forward and honey making the experience pleasant, datamitsu provides a foundation that is both reliable and enjoyable to work with.
+
+## What is datamitsu?
+
+Datamitsu is a **core engine** for configuration management and binary distribution, written in Go for performance and delivered as a single binary or npm package.
+
+It manages development tools and binaries across multiple platforms, handling downloads, SHA256 verification, caching, and execution. Configuration is defined in JavaScript (powered by the goja runtime), providing flexibility while maintaining type safety through TypeScript definitions.
+
+### Target Audience
+
+- **Config package creators** building opinionated tooling distributions
+- **Development teams** standardizing tool versions and configurations
+- **Projects** requiring reproducible development environments
+
+## Key Features
+
+- **Fast binary management** with SHA256 hash verification
+- **JavaScript-based configuration** with TypeScript definitions
+- **Multi-platform support**: darwin, linux, freebsd, openbsd, windows (amd64, arm64, aarch64)
+- **Three app types**:
+  - `binary` - Self-managed binaries with URLs, hashes, and archive formats
+  - `uvx` - Python packages via uvx (e.g., yamllint)
+  - `pnpm` - npm packages via pnpm dlx (e.g., @mermaid-js/mermaid-cli, @slidev/cli)
+- **Git hook integration** for pre-commit, commit-msg, and other hooks
+- **Smart caching** using stable hash-based paths for reproducibility
+- **Extensibility** - Build opinionated config packages on top
+
+## Architecture
+
+Datamitsu is designed as a **stable, rarely updated core engine** that provides the foundation for extensible configuration management:
+
+### Core Components
+
+**JavaScript Configuration Engine** ([internal/engine/](internal/engine/))
+
+- Uses goja JavaScript runtime to evaluate configuration files
+- Exposes console API, format utilities (YAML, TOML, INI), and tools API
+- Configuration defined in [internal/config/config.js](internal/config/config.js)
+
+**Binary Manager** ([internal/binmanager/](internal/binmanager/))
+
+- Downloads binaries with hash verification
+- Supports multiple archive formats: tar.gz, tar.xz, zip, gz, raw binaries
+- Caches binaries in `{cache}/.bin/{name}/{configHash}` with lazy loading
+- Executes binaries with environment passthrough
+
+**File Traverser** ([internal/traverser/](internal/traverser/))
+
+- Walks directory trees respecting .gitignore rules
+- Custom gitignore matcher implementation
+
+**CLI Commands** ([cmd/](cmd/))
+
+- `exec` - Execute managed binaries
+- `hook git` - Git hook management (pre-commit, commit-msg, etc.)
+- `hook npm` - npm lifecycle script hooks (preinstall, postinstall, etc.)
+- `init` - Initialization (TODO)
+
+For detailed architecture documentation, see [CLAUDE.md](CLAUDE.md).
+
+## Installation
+
+### As Standalone Binary
+
+```bash
+# Clone and build
+git clone https://github.com/shibanet0/s0conf.git
+cd s0conf
+pnpm build
+
+# Or just build with Go (after building JS config)
+go build
+```
+
+### As npm Package Dependency
+
+```json
+{
+  "dependencies": {
+    "datamitsu": "^0.0.0"
+  }
+}
+```
+
+## Quick Start
+
+Datamitsu provides several commands for managing development tools:
+
+```bash
+# Execute a managed binary
+./datamitsu exec <appName> [args...]
+
+# Git hook commands
+./datamitsu hook git pre-commit
+./datamitsu hook git commit-msg
+
+# npm lifecycle hooks
+./datamitsu hook npm preinstall
+./datamitsu hook npm postinstall
+```
+
+*Note: Detailed usage examples and configuration guides will be added in future releases.*
+
+## Development
+
+### Building
+
+```bash
+# Build JavaScript config and Go binary
+pnpm build
+
+# This runs:
+# 1. pnpm build:lib - Compiles TypeScript config to JavaScript
+# 2. go build - Compiles Go binary
+```
+
+### Testing
+
+```bash
+# Run Go tests
+go test ./...
+
+# Or use pnpm
+pnpm test
+```
+
+### Project Structure
+
+- `cmd/` - CLI command implementations (cobra framework)
+- `internal/binmanager/` - Binary download, verification, and execution
+- `internal/config/` - JavaScript configuration files and engine
+- `internal/engine/` - Goja JavaScript runtime integration
+- `internal/traverser/` - File system traversal with gitignore support
+- `internal/env/` - Environment and path utilities
+- `internal/logger/` - Structured logging (zap)
+- `internal/syslist/` - Platform detection and mapping
+
+See [CLAUDE.md](CLAUDE.md) for detailed architecture and implementation notes.
+
+## Extensibility Model
+
+Datamitsu is designed to be extended. The core engine provides stable binary management and configuration capabilities, while opinionated configurations are built as separate packages.
+
+### Building Opinionated Packages
+
+You can create your own configuration packages on top of datamitsu:
+
+1. **Create a new npm package** with datamitsu as a runtime dependency
+2. **Define your configurations** for ESLint, Prettier, lefthook, etc.
+3. **Include plugins and presets** specific to your team or project
+4. **Distribute as an npm package** that others can install
+
+Example structure:
+
+```json
+{
+  "name": "@yourscope/dev-config",
+  "dependencies": {
+    "datamitsu": "^0.0.0"
+  }
+}
+```
+
+This approach keeps the core stable while allowing the ecosystem to grow with various opinionated configurations tailored to different needs.
+
+## License
+
+MIT - See [LICENSE](LICENSE) for details
+
+## Contributing
+
+This project is in early development. Contribution guidelines will be established as the project matures.
+
+## Research & References
+
+For research notes and tool references, see [docs/research.md](docs/research.md).

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@datamitsu/datamitsu-linux-x64",
+  "version": "0.0.1-alpha-1",
+  "description": "The Linux x64 binary for datamitsu, configuration management and binary distribution tool",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shibanet0/s0conf.git"
+  },
+  "keywords": [
+    "datamitsu",
+    "config",
+    "binary",
+    "tools",
+    "linter"
+  ],
+  "author": "Alexander Svinarev <shibanet0@gmail.com> (shibanet0.com)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/shibanet0/s0conf/issues"
+  },
+  "homepage": "https://github.com/shibanet0/s0conf#readme",
+  "os": ["linux"],
+  "cpu": ["x64"]
+}