feat: Implement enum-based output formatters (Table, JSON, YARA)

.claude/settings.json

@@ -1,5 +1,3 @@
 {
-  "enabledPlugins": {
-    "commit@cc-marketplace": true
-  }
+  "enabledPlugins": {}
 }

.coderabbit.yml

@@ -351,7 +351,7 @@ reviews:
             - mode: "warning"
               name: "ASCII Only"
               instructions: |
-                  Verify that no Unicode punctuation is introduced:
+                  Verify that no Unicode punctuation is introduced unless explicitly required:
                   1. No emojis in code or documentation
                   2. No em-dashes - use regular hyphens
                   3. No smart quotes - use straight quotes

.devcontainer/devcontainer.json

@@ -0,0 +1,47 @@
+{
+	"name": "Rust",
+	"image": "mcr.microsoft.com/devcontainers/rust:2-1-trixie",
+	"features": {
+		"ghcr.io/devcontainers/features/docker-outside-of-docker:1": {
+			"installDockerBuildx": true,
+			"version": "latest",
+			"dockerDashComposeVersion": "v2",
+			"moby": false
+		},
+		"ghcr.io/devcontainers/features/github-cli:1": {
+			"installDirectlyFromGitHubRelease": true,
+			"version": "latest"
+		},
+		"ghcr.io/eitsupi/devcontainer-features/mdbook:1": {
+			"version": "latest"
+		},
+		"ghcr.io/devcontainers-extra/features/claude-code:1": {
+			"version": "latest"
+		},
+		"ghcr.io/devcontainers-extra/features/mise:1": {
+			"version": "latest"
+		}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"mikestead.dotenv",
+				"EditorConfig.EditorConfig",
+				"tamasfe.even-better-toml",
+				"github.vscode-github-actions",
+				"GitHub.vscode-pull-request-github",
+				"skellock.just",
+				"yzhang.markdown-all-in-one",
+				"bierner.markdown-checkbox",
+				"bierner.markdown-footnotes",
+				"bierner.markdown-mermaid",
+				"bierner.markdown-yaml-preamble",
+				"DavidAnson.vscode-markdownlint",
+				"rust-lang.rust-analyzer",
+				"foxundermoon.shell-format",
+				"redhat.vscode-yaml",
+				"ms-vscode-remote.remote-containers"
+			]
+		}
+	}
+}

.github/dependabot.yml

@@ -13,8 +13,12 @@ updates:
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      interval: "daily"
+      interval: "weekly"
   - package-ecosystem: "rust-toolchain"
     directory: "/"
     schedule:
-      interval: "daily"
+      interval: "weekly"
+  - package-ecosystem: "devcontainers"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.gitignore

@@ -121,9 +121,13 @@ docs/book/
 .envrc
 .direnv/
 
-megalinter-reports/
-
 # Override global gitignore
 !bin/
 # Added by goreleaser init:
 .intentionally-empty-file.o
+
+
+megalinter-reports/*
+target/*
+stringy-output/*
+tests/fixtures/*

.mdformat.toml

@@ -7,7 +7,6 @@ exclude = [
     "**/*.tpl.md",
     "**/CHANGELOG.md",
     "target/**",
-    "megalinter-reports/**",
 ]
 validate = true
 number = true
@@ -26,5 +25,4 @@ extensions = [
 
 [plugin.mkdocs]
 align_semantic_breaks_in_lists = true
-ignore_missing_references = true
-
+ignore_missing_references      = true

.repomixignore

@@ -0,0 +1,4 @@
+megalinter-reports/*
+target/*
+stringy-output/*
+tests/fixtures/*

.vscode/settings.json

@@ -0,0 +1,12 @@
+{
+    "ruff.path": [
+        "${workspaceFolder}/.vscode/mise-tools/ruff"
+    ],
+    "ruff.interpreter": [
+        "${workspaceFolder}/.vscode/mise-tools/python"
+    ],
+    "python.defaultInterpreterPath": "${workspaceFolder}/.vscode/mise-tools/python",
+    "debug.javascript.defaultRuntimeExecutable": {
+        "pwa-node": "${workspaceFolder}/.vscode/mise-tools/node"
+    }
+}

AGENTS.md

@@ -6,24 +6,25 @@
 
 1. **No `unsafe` code** - `#![forbid(unsafe_code)]` enforced
 2. **Zero warnings** - `cargo clippy -- -D warnings` must pass
-3. **ASCII only** - No emojis, em-dashes, smart quotes, or Unicode punctuation
+3. **ASCII only** - No emojis, em-dashes, smart quotes, or Unicode punctuation (except when explicitly testing or working with Unicode strings or emojis)
 4. **File size limit** - Keep files under 500 lines; split larger files
 5. **No blanket `#[allow]`** - Any `allow` requires inline justification
 
 ## Project Summary
 
 Stringy extracts meaningful strings from ELF, PE, and Mach-O binaries using format-specific knowledge and semantic classification. Unlike standard `strings`, it is section-aware and semantically intelligent.
 
-**Data flow**: Binary -> Format Detection -> Container Parsing -> String Extraction -> Deduplication -> Classification -> Ranking -> Output
+- **Rust**: Edition 2024, MSRV 1.91
+- **Data flow**: Binary -> Format Detection -> Container Parsing -> String Extraction -> Deduplication -> Classification -> Ranking -> Output
 
 ## Module Structure
 
 | Module            | Purpose                                                          |
 | ----------------- | ---------------------------------------------------------------- |
 | `container/`      | Format detection, section analysis, imports/exports via `goblin` |
 | `extraction/`     | ASCII/UTF-8/UTF-16 extraction, deduplication, PE resources       |
-| `classification/` | Semantic tagging (URLs, IPs, domains, paths, GUIDs)              |
-| `output/`         | Formatters (JSON, human-readable, YARA-friendly)                 |
+| `classification/` | Semantic tagging (URLs, IPs, domains, paths, GUIDs), ranking     |
+| `output/`         | Formatters: `json/`, `table/` (tty/plain), `yara/`               |
 | `types/`          | Core data structures, error handling with `thiserror`            |
 
 ## Key Patterns
@@ -48,6 +49,10 @@ just test       # Run tests with nextest
 just lint       # Full lint suite
 just fix        # Auto-fix clippy warnings
 just ci-check   # Full CI suite locally
+just build      # Debug build
+just run <args> # Run stringy with arguments
+just bench      # Run benchmarks
+just format     # Format all (Rust, JSON, YAML, Markdown, Justfile)
 ```
 
 ## Testing
@@ -60,6 +65,14 @@ just ci-check   # Full CI suite locally
 
 Import from `stringy::extraction` or `stringy::types`, not deeply nested paths. Re-exports are in `lib.rs`.
 
+## Key Dependencies
+
+- `goblin` - Binary format parsing (ELF, PE, Mach-O)
+- `pelite` - PE resource extraction
+- `thiserror` - Error type definitions
+- `insta` - Snapshot testing (dev)
+- `criterion` - Benchmarking (dev)
+
 ## Adding Features
 
 **New semantic tag**: Add variant to `Tag` enum in `types.rs`, implement pattern in `classification/semantic.rs`

CHANGELOG.md

@@ -0,0 +1,53 @@
+# 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).
+
+## [Unreleased]
+
+### Added
+- Output formatters: JSON (JSONL), table (TTY-friendly), and YARA rule templates
+- `generated_at` timestamp support in output metadata for deterministic outputs
+- Ranking system for prioritizing extracted strings by relevance
+- Symbol demangling support for Rust mangled names
+- File path classification for POSIX, Windows, and registry paths
+- Semantic classification for URLs, domains, and IP addresses (IPv4/IPv6)
+- String deduplication with full occurrence metadata preservation
+- `CanonicalString` type for deduplicated strings with occurrence tracking
+- UTF-16 string extraction with confidence scoring
+- Noise filtering framework with entropy, linguistic, and repetition filters
+- Mach-O load command extraction with section weight normalization
+- Comprehensive PE support: section classification, import/export parsing, resource extraction
+- ELF symbol extraction with type support and visibility filtering
+- `#[non_exhaustive]` and builder pattern for `FoundString` public API
+- Contributing guidelines document
+
+### Changed
+- Repository renamed from StringyMcStringFace to Stringy
+- Improved YARA formatter code quality and test coverage
+- Clarified ASCII rule for Unicode handling in documentation
+
+### Fixed
+- Rustdoc warning for IPv6 address example in documentation
+
+### Dependencies
+- Updated criterion to 0.8.1
+- Updated actions/checkout to v6
+- Updated actions/download-artifact to v7
+- Updated actions/attest-build-provenance to v3
+- Updated actions/upload-artifact to v5
+- Updated github/codeql-action to v4
+- Updated EmbarkStudios/cargo-deny-action to v2
+
+## [0.1.0] - TBD
+
+Initial release with core functionality:
+
+### Added
+- ELF, PE, and Mach-O binary format detection and parsing
+- ASCII and UTF-8 string extraction from binary sections
+- Section-aware extraction with weight-based prioritization
+- Basic semantic tagging infrastructure
+- Command-line interface (in development)

CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# Contributing to Stringy
+
+Thanks for your interest in Stringy. This guide explains how to propose changes and what we expect for code quality.
+
+## Quick start
+
+1. Search existing issues and pull requests before filing a new one.
+2. For bugs, open an issue with a clear reproduction and expected vs actual behavior.
+3. For new features or larger changes, open an issue first to discuss scope.
+
+## Development setup
+
+Stringy uses Rust 2024 (MSRV 1.85+, see `rust-toolchain.toml`). We also use just for common tasks.
+
+Recommended workflow:
+
+- `just setup` (to install tools)
+- `just build` (compiles a debug build)
+- `just test` (runs tests)
+- `just lint` (runs linters)
+
+If you do not use just, the critical requirement is that:
+
+- `cargo clippy -- -D warnings` passes
+- `cargo fmt` produces no changes
+
+## Coding standards
+
+These rules are enforced by CI:
+
+- No unsafe code
+- Zero warnings (`clippy -D warnings`)
+- ASCII only in code and documentation, unless explicitly working with Unicode handling
+- Keep files under 500-600 lines; split when needed
+- No blanket `#[allow]` on modules or files
+- No async; this is a synchronous CLI tool
+
+Use thiserror for structured errors and include context (offsets, section names, file paths) when relevant.
+
+## Project-specific guidance
+
+Module layout:
+
+- `container/` handles format detection and section analysis
+- `extraction/` handles string extraction, filtering, and deduplication
+- `classification/` handles semantic tagging and ranking
+- `output/` handles output formatters
+- `types.rs` contains core data structures and error types
+
+Key patterns:
+
+- Section weights: add new section weights in `container/*.rs` using existing match patterns. Higher weight means more likely to contain useful strings.
+- Semantic tags: add new Tag variants in `types.rs`, implement detection in `classification/semantic.rs`, and update any tag merging logic if needed.
+- Deduplication: preserve all occurrences and merge tags across occurrences in `extraction/dedup.rs`.
+- Public structs: keep public API structs non_exhaustive and provide explicit constructors.
+- Imports: prefer `stringy::extraction` or `stringy::types`. Do not import locally-defined types inside `extraction/mod.rs`.
+
+## Tests
+
+- Add or update tests for behavior changes.
+- Use insta snapshots for output verification when appropriate.
+- Integration tests live in tests/ and fixtures in tests/fixtures/.
+- Use insta snapshots for output verification when changing output formatters.
+
+Run:
+
+- `just test`
+
+## Pull requests
+
+- Keep PRs focused and small when possible.
+- Include a clear description of the problem and the solution.
+- Link related issues in the PR description.
+- Update documentation when behavior changes.
+
+## Documentation
+
+Docs live under docs/ and project planning artifacts are in project_plan/. Update them when you change user-facing behavior.
+
+## Security
+
+If you believe you found a security issue, please do not open a public issue. Use GitHub Security Advisories if available, or contact the maintainers privately.
+
+## AI-assisted development
+
+This project includes Claude Code configuration in `.claude/settings.json`. These settings enable plugins that help maintain code quality and follow project conventions. If you use Claude Code, the configuration will be applied automatically.
+
+## Questions
+
+If you are unsure where to start, open an issue with your question and we will point you in the right direction.