# DevCraft: Complete Machine-Readable Technical Documentation

> Zero-Latency Developer & Architecture Suite. Air-gapped, zero-cloud developer tools running 100% in client-side browser RAM.
> Canonical URL: https://devcraft.run
> Specification Standard: LLMs.txt Full Reference

---

## 1. System Overview & Architecture

DevCraft is an open developer suite designed for privacy-critical software engineering workflows. Modern web utilities frequently transmit code snippets, API tokens, database schemas, and proprietary configurations to remote backend servers. DevCraft eliminates this security liability through an entirely client-side architecture:

- **100% Client-Side In-Memory Execution**: Every computation (syntax parsing, cryptographic signing, AST traversal, diagram compilation) runs inside the browser's JavaScript engine and Web Workers.
- **Air-Gapped Privacy**: No telemetry of user payloads, no remote database storage, and no server-side logging. Network inspection during tool usage reveals zero outbound requests carrying user payloads.
- **RFC 3986 URL Hash State Sharing**: When generating shareable URLs, data is compressed using the LZ-String algorithm into the URL hash fragment (`#data=...`). By standard HTTP specifications, the hash fragment is never transmitted over the wire to any server.
- **Offline Reliability**: Once loaded or cached, all tools continue functioning without an active network connection.

---

## 2. Tools Index & Technical Specifications

### 2.1. JSON Delta (Semantic JSON Diff & RFC 6902 Patch)
- **URL**: https://devcraft.run/tools/json-diff
- **Category**: Data & Contracts
- **Key Standards**: RFC 6902 (JavaScript Object Notation (JSON) Patch), RFC 8259 (JSON Data Interchange Format).
- **Core Capabilities**:
  - Semantic JSON comparison independent of key ordering.
  - Side-by-side split view and unified git-style diff view.
  - Automatic compilation of differences into standard RFC 6902 JSON Patch arrays (add, remove, replace, move, copy).
  - Validation error boundaries highlighting syntax issues with line and column accuracy.
- **How It Works**:
  1. Lexical parsing converts both inputs into Abstract Syntax Trees (AST) in local memory.
  2. A recursive structural traversal walks object keys and array indices in parallel, classifying differences into additions (+), removals (-), or value modifications (~).
  3. Longest Common Subsequence (LCS) dynamic programming computes optimal line alignment for the split view.
  4. Differences serialize into JSON Patch format ready for HTTP PATCH API consumption.
- **RFC 6902 Operations Reference**:
  - `add`: Inserts a value into an object or array at the target path (e.g., `{"op": "add", "path": "/users/0", "value": {"name": "Alice"}}`).
  - `remove`: Removes an element or key at the target path (e.g., `{"op": "remove", "path": "/database/password"}`).
  - `replace`: Updates an existing value at the target path (e.g., `{"op": "replace", "path": "/version", "value": "2.0.0"}`).
  - `move`: Relocates a value from one path location to another (e.g., `{"op": "move", "from": "/oldName", "path": "/newName"}`).

### 2.2. ArchFlow (Interactive Mermaid 11 Architecture Studio)
- **URL**: https://devcraft.run/tools/mermaid-editor
- **Category**: Architecture & Design
- **Key Standards**: Mermaid.js v11 syntax, W3C SVG 1.1/2.0.
- **Core Capabilities**:
  - Live rendering of cloud architecture diagrams, database schemas, and sequence flows.
  - Interactive pan, zoom, and fit-to-canvas controls.
  - High-resolution Retina export in vector SVG and PNG (up to 4x resolution).
  - Curated architectural templates: Microservices Auth Gateway, Distributed Event Pipeline, Kubernetes Ingress Controller, Entity-Relationship Data Model.
- **Supported Diagram Types**:
  - Flowcharts (`graph TD`, `flowchart LR`)
  - Sequence Diagrams (`sequenceDiagram`)
  - Class Diagrams (`classDiagram`)
  - State Diagrams (`stateDiagram-v2`)
  - Entity-Relationship Diagrams (`erDiagram`)
  - Git Graphs (`gitGraph`)
  - Mindmaps (`mindmap`)
  - Timelines and Gantt Charts (`timeline`, `gantt`)
- **How It Works**:
  1. The code input is dynamically evaluated via the in-browser Mermaid 11 compiler inside a isolated sandbox.
  2. Errors are caught and presented with syntax pointers rather than breaking the application state.
  3. SVG elements are drawn onto an interactive canvas supporting mouse drag and wheel zoom.

### 2.3. cURL Probe (HTTP Request Builder & Code Generator)
- **URL**: https://devcraft.run/tools/curl-probe
- **Category**: Networking & APIs
- **Key Standards**: RFC 9110 (HTTP Semantics), RFC 9112 (HTTP/1.1), cURL CLI format.
- **Core Capabilities**:
  - Client-side construction and execution of HTTP requests (GET, POST, PUT, DELETE, PATCH, HEAD).
  - Header inspection, query parameter manipulation, and JSON/Form payload validation.
  - Latency timing and response status visualization.
  - Multilingual code snippet export: cURL CLI, JavaScript Fetch API, Axios, Python Requests, Go HTTP, Node.js HTTP.
- **How It Works**:
  1. Parses raw cURL command lines or structured inputs into method, URL, headers, and body objects.
  2. Dispatches in-browser fetch requests respecting CORS policies.
  3. Measures time-to-first-byte (TTFB) and formats responses with syntax highlighting.

### 2.4. JWT Inspector (RFC 7519 Token Parser & Validator)
- **URL**: https://devcraft.run/tools/jwt-inspector
- **Category**: Security & Auth
- **Key Standards**: RFC 7519 (JSON Web Token), RFC 7515 (JSON Web Signature), Web Crypto API (W3C Recommendation).
- **Core Capabilities**:
  - Parses three-part dot-delimited tokens: Header, Payload, and Signature.
  - Base64URL decodes tokens in browser RAM without server submission.
  - Validates standard claims: Expiration Time (`exp`), Not Before (`nbf`), Issued At (`iat`).
  - Signature verification using HMAC-SHA256 (`HS256`) via native browser Web Crypto API (`window.crypto.subtle`).
- **Standard Claims Reference**:
  - `iss` (Issuer): Identifies the principal that issued the JWT.
  - `sub` (Subject): Identifies the principal that is the subject of the JWT.
  - `aud` (Audience): Identifies the recipients that the JWT is intended for.
  - `exp` (Expiration Time): Identifies the expiration time on or after which the JWT must not be accepted.
  - `nbf` (Not Before): Identifies the time before which the JWT must not be accepted.
  - `iat` (Issued At): Identifies the time at which the JWT was issued.

### 2.5. CronForge (Cron Schedule Generator & Natural Language Translator)
- **URL**: https://devcraft.run/tools/cron-generator
- **Category**: DevOps & Scheduling
- **Key Standards**: POSIX IEEE 1003.1 Cron specification, Quartz Cron 6-part format.
- **Core Capabilities**:
  - Real-time bidirectional translation between 5/6-part cron expressions and clear English prose.
  - Interactive schedule builder covering minutes, hours, days of month, months, and days of week.
  - Calculation and display of the next 5 deterministic execution timestamps.
  - Common preset shortcuts: Every minute, hourly, daily at midnight, weekly, monthly.
- **Field Breakdown**:
  - Field 1 (Minute): 0-59
  - Field 2 (Hour): 0-23
  - Field 3 (Day of Month): 1-31
  - Field 4 (Month): 1-12 or JAN-DEC
  - Field 5 (Day of Week): 0-7 (0 or 7 is Sunday) or SUN-SAT
  - Special Characters: `*` (every value), `,` (value list), `-` (range), `/` (step values).

### 2.6. SQL Beautifier (Multi-Dialect Formatter & Case Normalizer)
- **URL**: https://devcraft.run/tools/sql-formatter
- **Category**: Databases & Queries
- **Key Standards**: ANSI SQL-92, SQL:1999, PostgreSQL, MySQL, SQLite, Transact-SQL.
- **Core Capabilities**:
  - Deterministic SQL formatting with custom indentation (2 spaces, 4 spaces, or tabs).
  - Keyword casing normalization (UPPERCASE or lowercase).
  - Clean separation of clauses (SELECT, FROM, WHERE, GROUP BY, HAVING, ORDER BY, WINDOW).
  - In-browser parsing avoiding leakage of proprietary database schemas or confidential table structures.

### 2.7. RegexSandbox (PCRE & JavaScript Regular Expression Tester)
- **URL**: https://devcraft.run/tools/regex-tester
- **Category**: Text Processing
- **Key Standards**: ECMAScript RegExp specification, PCRE matching conventions.
- **Core Capabilities**:
  - Real-time regular expression evaluation as the user types.
  - Full flag support: global (`g`), case-insensitive (`i`), multiline (`m`), dotAll (`s`), unicode (`u`), sticky (`y`).
  - Capture group inspection (named and numbered groups) with index boundaries.
  - Comprehensive syntax cheatsheet covering character classes, quantifiers, lookahead, and lookbehind.

---

## 3. Privacy, Compliance, and Data Governance

1. **Zero Data Retention**: DevCraft does not operate user accounts, databases, or cloud storage for user input. All data remains exclusively within the user's browser session.
2. **Third-Party Disclosures**:
   - Google AdSense: Non-intrusive developer advertising adheres to Google AdSense Program Policies. Users can manage ad preferences via Google Ads Settings.
   - Google Analytics 4: Aggregated page navigation trends are measured using anonymized first-party cookies. Opt-out is available via the Google Analytics Opt-out Browser Add-on.
   - Cloudflare Web Analytics: Collects aggregate traffic statistics without cookies or personal IP tracking.
3. **Open Standards Alignment**: DevCraft uses standard W3C, IETF RFC, and POSIX protocols throughout its utility catalog.

---

## 4. Contact & Support

- **Email**: rahmad.mukminullah@gmail.com
- **Website**: https://devcraft.run
- **Contact Page**: https://devcraft.run/contact
- **Source Repository**: https://github.com/naturalizerINA
