@wistantkode/dotfiles 1.2.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/CHANGELOG.md +5 -3
  2. package/README.md +46 -39
  3. package/assets/memoji.png +0 -0
  4. package/package.json +1 -1
  5. package/protocols/RELEASE.md +10 -0
package/CHANGELOG.md CHANGED
@@ -2,17 +2,19 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
- ## [1.2.1] - 2026-04-04 - [Documentation & Branding]
5
+ ## [1.3.0] - 2026-04-04 - [Architectural Identity & AI Orchestration]
6
6
 
7
7
  ### Added
8
8
 
9
9
  - **AI-Driven Infrastructure**: Re-engineered the repository documentation to focus on AI-pairing orchestration and guardrails.
10
- - **Branding Assets**: Included professional logos and technical icons for the ecosystem.
10
+ - **Branding Assets**: Included professional logos, technical icons, and a custom **Memoji** for the ecosystem.
11
11
  - **Legal Compliance**: Integrated **Apache License 2.0** as the project's legal baseline.
12
12
 
13
13
  ### Changed
14
14
 
15
- - **Premium Documentation**: Completely redesigned `README.md` with architectural diagrams and deep technical storytelling.
15
+ - **Premium Documentation**: Completely redesigned `README.md` (v6) with a professional horizontal header and architectural storytelling.
16
+ - **Protocol Hardening**: Updated `RELEASE.md` with explicit state-verification and autonomous audit phases.
17
+ - **Identity Alignment**: Corrected all internal references to GitHub (`wistant`) and NPM (`@wistantkode`).
16
18
 
17
19
  ### Removed
18
20
 
package/README.md CHANGED
@@ -1,8 +1,21 @@
1
+ # [@wistantkode/dotfiles](https://www.npmjs.com/package/@wistantkode/dotfiles)
2
+
1
3
  <div align="center">
4
+ <table border="0" cellpadding="0" cellspacing="0">
5
+ <tr>
6
+ <td align="center" valign="middle">
7
+ <img src="./assets/wistant-logo.png" alt="Wistant Logo" width="100" />
8
+ </td>
9
+ <td align="center" valign="middle" style="padding: 0 40px;">
10
+ <img src="./assets/memoji.png" alt="Memoji" width="120" />
11
+ </td>
12
+ <td align="center" valign="middle">
13
+ <img src="./assets/dotfiles.png" alt="Dotfiles Logo" width="100" />
14
+ </td>
15
+ </tr>
16
+ </table>
2
17
  <br />
3
- <img src="./assets/wistant-logo.png" alt="Wistant Logo" width="160" />
4
- <h1>@wistantkode/dotfiles</h1>
5
- <p><b>Orchestrating AI-Driven Development through Professional Infrastructure</b></p>
18
+ <p><b>Precision AI-Pairing Infrastructure & Architectural Protocols</b></p>
6
19
 
7
20
  <p>
8
21
  <a href="https://www.npmjs.com/package/@wistantkode/dotfiles">
@@ -19,69 +32,63 @@
19
32
 
20
33
  ---
21
34
 
22
- ## The Concept: AI-Driven Architecture
35
+ ## Infrastructure Orchestration
23
36
 
24
- Modern development is increasingly AI-pair-programmed. However, without strict guardrails, AI interactions often lead to repository entropy, messy commits, and inconsistent versioning.
37
+ This is more than a dotfiles collection; it is a **System of Governance** for AI-driven development workflows. By treating your environment as **Versioned Infrastructure**, you establish the necessary guardrails to ensure that AI-pair-programming remains precise, atomic, and secure.
25
38
 
26
- This repository provides the **Architectural Framework** necessary to pilot an AI effectively. It transforms a standard "dotfiles" collection into a set of **Instructional Protocols** that enforce engineering integrity at every step.
39
+ ### The System Advantage
27
40
 
28
- ---
41
+ - **AI-Driven Logic**: The system is designed to "pilot" your AI assistant. It provides the architectural context and socratic protocols (`.protocols/`) required for high-end decision making.
42
+ - **Atomic Reliability**: Every modification is routed through a verification cycle that prevents history pollution and mixed intentions.
43
+ - **Universal Staging**: Powered by **pnpm**, **JavaScript (ESM)**, and **Shell orchestration**, the entire ecosystem is instantly deployable via `npx` or `pnpm dlx`.
29
44
 
30
- ## Infrastructure Flow
45
+ ---
31
46
 
32
- The system ensures that every modification is audited locally before reaching the public registry.
47
+ ## Operational Workflow
33
48
 
34
49
  ```mermaid
35
50
  graph TD
36
- A[Local AI-Pairing] -- Socratic Audit --> B[Atomic Commit]
37
- B -- github.sh Check --> C[GitHub Mirror]
38
- C -- Version Tag --> D[GitHub Actions]
39
- D -- Security Scan & Publish --> E[NPM Registry]
40
- F[New Environment] -- npx installer --> E
51
+ A[Socratic AI-Pairing] -- Atomic Audit --> B[Local Commit Sequence]
52
+ B -- github.sh Gatekeeper --> C[GitHub Mirror]
53
+ C -- Automated CI/CD --> D[GitHub Actions]
54
+ D -- Security & Distribution --> E[NPM Global Registry]
55
+ F[Remote Deployment] -- pnpm dlx --> E
41
56
  ```
42
57
 
43
- ---
44
-
45
- ## Concrete Value & Assets
46
-
47
- ### 1. AI Piloting Protocols (`.protocols/`)
48
- A hidden library of instructions that you inject into your AI-Pairing sessions to enforce professional standards:
49
- - **COMMIT.md**: Forces the AI to decompose complex changes into atomic, verifiable intentions.
50
- - **RELEASE.md**: A socratic dialogue to ensure semantic versioning (SemVer) reflects the technical reality.
51
- - **RODIN.md**: The engineering philosophy that prevents AI compliancy and focus-drift.
58
+ ### Core Automation Tools
52
59
 
53
- ### 2. Intelligent Synchronization (`github.sh`)
54
- An interactive script that acts as a final gatekeeper. It identifies uncommitted files and "Tag Deltas" (local versions not yet on GitHub) to prevent broken releases.
55
-
56
- ### 3. Professional Templates
57
- - **Standardized `.gitignore`**: A production-ready model to avoid history pollution.
58
- - **`.gitmessage` Template**: A structured baseline for all commits, compatible with modern changelog generators.
59
- - **NPM Integration**: Every configuration is a versioned package, deployable via `npx` or `pnpm dlx`.
60
+ 1. **Interactive Sync (`github.sh`)**: A specialized gatekeeper that performs a "Tag Delta" audit, ensuring local versions and remote states are synchronized before any projection.
61
+ 2. **System Protocols**: A library of hidden guides that force the AI to maintain professional standards (Atomic commits, Socratic releases, Security first).
62
+ 3. **Automated Distribution**: GitHub Actions handle the security auditing and global NPM publication upon Every GitHub Release.
60
63
 
61
64
  ---
62
65
 
63
- ## Deployment
66
+ ## Practical Implementation
64
67
 
65
- Initialize your AI-driven environment on any Linux system:
68
+ Deploy your architectural baseline anywhere:
66
69
 
67
70
  ```bash
68
71
  pnpm dlx @wistantkode/dotfiles
69
72
  ```
70
73
 
74
+ ### Included Assets
75
+ - **Professional `.gitignore`**: PRODUCTION-READY baseline for all modern stacks.
76
+ - **`.gitmessage` Architectural Template**: Standardizes commit intentions across teams.
77
+ - **Governance Library**: Injected `.protocols/` folder for immediate AI alignment.
78
+
71
79
  ---
72
80
 
73
- ## Standards Registry
81
+ ## Engineering Standards
74
82
 
75
- | Component | Role | Link |
83
+ | Standard | Role | Reference |
76
84
  | :--- | :--- | :--- |
77
- | **Integrity Standards** | Engineering philosophy and socratic audit rules. | [RODIN.md](./protocols/RODIN.md) |
78
- | **Commit Rules** | Atomic formatting and Zero-Entropy guardrails. | [COMMIT.md](./protocols/COMMIT.md) |
79
- | **Release Logic** | Step-by-step SemVer validation and sealing. | [RELEASE.md](./protocols/RELEASE.md) |
80
- | **Security Audit** | Vulnerability scanning and secret management. | [SECURITY.md](./protocols/SECURITY.md) |
85
+ | **Integrity Audit** | High-level engineering and architectural philosophy. | [RODIN.md](./protocols/RODIN.md) |
86
+ | **Commit Protocol** | Strict atomic formatting and zero-entropy staging. | [COMMIT.md](./protocols/COMMIT.md) |
87
+ | **Release Flow** | Socratic versioning and manual sealing logic. | [RELEASE.md](./protocols/RELEASE.md) |
81
88
 
82
89
  ---
83
90
 
84
- ## Licensing
91
+ ## License
85
92
 
86
93
  Copyright © 2026 **Wistant**. Distributed under the **Apache License 2.0**.
87
94
 
package/assets/memoji.png ADDED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wistantkode/dotfiles",
3
- "version": "1.2.1",
3
+ "version": "1.3.0",
4
4
  "description": "High-End Linux Infrastructure & AI-Driven Orchestration Protocols",
5
5
  "main": "index.js",
6
6
  "type": "module",
package/protocols/RELEASE.md CHANGED
@@ -8,6 +8,16 @@ Tu dois appliquer le protocole suivant, étape par étape, sans jamais sauter un
8
8
 
9
9
  ---
10
10
 
11
+ ## PHASE 0 : IDENTIFICATION DE L'ÉTAT (Solidité)
12
+
13
+ Avant toute discussion, tu dois impérativement identifier où nous sommes techniquement.
14
+
15
+ 1. **Lecture du Manifeste** : Lis le `package.json` pour identifier la version actuelle (ex: `1.2.1`).
16
+ 2. **Localisation du Tag** : Vérifie via `git log --decorate` si le tag correspondant à la version du manifeste est bien présent sur le dernier commit de production.
17
+ 3. **Audit de Drift** : Identifie les commits effectués depuis le dernier tag.
18
+
19
+ ---
20
+
11
21
  ## PHASE 1 : L'AUDIT SILENCIEUX (Analyse Aveugle)
12
22
 
13
23
  *Ne communique pas le résultat de cette phase à l'utilisateur.*