@wistantkode/dotfiles 1.2.1 → 1.4.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.
- package/CHANGELOG.md +25 -3
- package/README.md +46 -39
- package/assets/memoji.png +0 -0
- package/github.sh +34 -34
- package/package.json +1 -1
- package/protocols/ASSIST.md +29 -14
- package/protocols/COMMIT.md +1 -1
- package/protocols/DOTFILES.md +1 -2
- package/protocols/INIT.md +6 -6
- package/protocols/RELEASE.md +11 -1
- package/protocols/RODIN.md +27 -23
- package/protocols/SECURITY.md +5 -3
- package/protocols/_INDEX.md +21 -10
- package/gitmessage +0 -14
package/CHANGELOG.md
CHANGED
|
@@ -2,17 +2,39 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to this project will be documented in this file.
|
|
4
4
|
|
|
5
|
-
## [1.
|
|
5
|
+
## [1.4.0] - 2026-04-05 - [Community-Grade Governance]
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- **Complete Protocol Index**: `_INDEX.md` expanded from 5 to 9 entries, covering all protocols (`INIT`, `REFACTOR`, `TEST`, `DOTFILES`).
|
|
10
|
+
- **Activation Triggers**: `RODIN.md` and `INIT.md` now include explicit `[!IMPORTANT]` activation blocks for unambiguous agent invocation.
|
|
11
|
+
- **Generalized Security Phase**: `SECURITY.md` Phase 3 now covers JWT, HMAC, OAuth, and data isolation patterns beyond Prisma-specific scope.
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
|
|
15
|
+
- **Community-Grade Rewrite**: `github.sh` fully rewritten in technical English with system-style labels (`[ABORT]`, `[WARNING]`, `[PUSH]`, `[GATE]`). All personal/informal language removed.
|
|
16
|
+
- **Stack-Agnostic Protocols**: `ASSIST.md` operational modes decoupled from specific stacks (Next.js, Tailwind, Shadcn). Now applicable to any engineering context.
|
|
17
|
+
- **Cross-Reference Integrity**: All protocol cross-references in `ASSIST.md` and `_INDEX.md` are now complete and consistent.
|
|
18
|
+
- **RODIN.md**: Rewritten in English, neutral community tone. Suitable for external contributors.
|
|
19
|
+
- **RELEASE.md**: Monorepo path references generalized to support both single-package and workspace architectures.
|
|
20
|
+
|
|
21
|
+
### Removed
|
|
22
|
+
|
|
23
|
+
- **`gitmessage` template**: Superseded by the `COMMIT.md` protocol. Removed to eliminate redundancy.
|
|
24
|
+
|
|
25
|
+
## [1.3.0] - 2026-04-04 - [Architectural Identity & AI Orchestration]
|
|
6
26
|
|
|
7
27
|
### Added
|
|
8
28
|
|
|
9
29
|
- **AI-Driven Infrastructure**: Re-engineered the repository documentation to focus on AI-pairing orchestration and guardrails.
|
|
10
|
-
- **Branding Assets**: Included professional logos
|
|
30
|
+
- **Branding Assets**: Included professional logos, technical icons, and a custom **Memoji** for the ecosystem.
|
|
11
31
|
- **Legal Compliance**: Integrated **Apache License 2.0** as the project's legal baseline.
|
|
12
32
|
|
|
13
33
|
### Changed
|
|
14
34
|
|
|
15
|
-
- **Premium Documentation**: Completely redesigned `README.md` with
|
|
35
|
+
- **Premium Documentation**: Completely redesigned `README.md` (v6) with a professional horizontal header and architectural storytelling.
|
|
36
|
+
- **Protocol Hardening**: Updated `RELEASE.md` with explicit state-verification and autonomous audit phases.
|
|
37
|
+
- **Identity Alignment**: Corrected all internal references to GitHub (`wistant`) and NPM (`@wistantkode`).
|
|
16
38
|
|
|
17
39
|
### Removed
|
|
18
40
|
|
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
|
-
<
|
|
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
|
-
##
|
|
35
|
+
## Infrastructure Orchestration
|
|
23
36
|
|
|
24
|
-
|
|
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
|
-
|
|
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
|
-
|
|
45
|
+
---
|
|
31
46
|
|
|
32
|
-
|
|
47
|
+
## Operational Workflow
|
|
33
48
|
|
|
34
49
|
```mermaid
|
|
35
50
|
graph TD
|
|
36
|
-
A[
|
|
37
|
-
B -- github.sh
|
|
38
|
-
C --
|
|
39
|
-
D -- Security
|
|
40
|
-
F[
|
|
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
|
-
|
|
54
|
-
|
|
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
|
-
##
|
|
66
|
+
## Practical Implementation
|
|
64
67
|
|
|
65
|
-
|
|
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
|
|
81
|
+
## Engineering Standards
|
|
74
82
|
|
|
75
|
-
|
|
|
83
|
+
| Standard | Role | Reference |
|
|
76
84
|
| :--- | :--- | :--- |
|
|
77
|
-
| **Integrity
|
|
78
|
-
| **Commit
|
|
79
|
-
| **Release
|
|
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
|
-
##
|
|
91
|
+
## License
|
|
85
92
|
|
|
86
93
|
Copyright © 2026 **Wistant**. Distributed under the **Apache License 2.0**.
|
|
87
94
|
|
|
Binary file
|
package/github.sh
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# --- GITHUB SYNC (SYSTEM PROTOCOL) ---
|
|
4
4
|
|
|
5
|
-
#
|
|
5
|
+
# Colors & Style
|
|
6
6
|
GRAY='\033[90m'
|
|
7
7
|
BOLD='\033[1m'
|
|
8
8
|
RED='\033[31m'
|
|
@@ -11,22 +11,22 @@ YELLOW='\033[33m'
|
|
|
11
11
|
CYAN='\033[36m'
|
|
12
12
|
RESET='\033[0m'
|
|
13
13
|
|
|
14
|
-
#
|
|
14
|
+
# Utilities
|
|
15
15
|
print_banner() {
|
|
16
16
|
echo -e "${GRAY}--------------------------------------------------${RESET}"
|
|
17
17
|
echo -e "${BOLD} INTEGRITY AUDIT : GITHUB SYNC${RESET}"
|
|
18
18
|
echo -e "${GRAY}--------------------------------------------------${RESET}"
|
|
19
19
|
}
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
echo -e "\n${RED}${BOLD}
|
|
23
|
-
echo -e "${GRAY}
|
|
21
|
+
abort() {
|
|
22
|
+
echo -e "\n${RED}${BOLD}[ABORT]${RESET} $1"
|
|
23
|
+
echo -e "${GRAY}Infrastructure integrity takes precedence over speed.${RESET}"
|
|
24
24
|
echo -e "${GRAY}--------------------------------------------------${RESET}"
|
|
25
25
|
exit 1
|
|
26
26
|
}
|
|
27
27
|
|
|
28
28
|
ask_confirm() {
|
|
29
|
-
echo -ne "${YELLOW}${BOLD}
|
|
29
|
+
echo -ne "${YELLOW}${BOLD}[CONFIRM]${RESET} $1 [y/N] "
|
|
30
30
|
read -r response
|
|
31
31
|
if [[ ! "$response" =~ ^([yY][eE][sS]|[yY])$ ]]; then
|
|
32
32
|
return 1
|
|
@@ -34,22 +34,22 @@ ask_confirm() {
|
|
|
34
34
|
return 0
|
|
35
35
|
}
|
|
36
36
|
|
|
37
|
-
# ---
|
|
37
|
+
# --- AUDIT START ---
|
|
38
38
|
print_banner
|
|
39
39
|
|
|
40
|
-
# 1.
|
|
40
|
+
# 1. Working Tree Audit
|
|
41
41
|
if ! git diff-index --quiet HEAD --; then
|
|
42
|
-
echo -e "${YELLOW}
|
|
42
|
+
echo -e "${YELLOW}[WARNING]${RESET} Uncommitted changes detected in the working tree."
|
|
43
43
|
git status -s
|
|
44
|
-
|
|
44
|
+
abort "History is not clean. Remote projection requires a pure commit history."
|
|
45
45
|
fi
|
|
46
46
|
|
|
47
|
-
# 2.
|
|
47
|
+
# 2. Branch Detection
|
|
48
48
|
CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
|
|
49
|
-
echo -e "${BOLD}
|
|
49
|
+
echo -e "${BOLD}[CONTEXT]${RESET} Current branch: ${CYAN}${BOLD}${CURRENT_BRANCH}${RESET}"
|
|
50
50
|
|
|
51
|
-
# 3.
|
|
52
|
-
echo -e "${GRAY}
|
|
51
|
+
# 3. Tag Delta Audit (Local vs Remote)
|
|
52
|
+
echo -e "${GRAY}[AUDIT] Scanning tag versions...${RESET}"
|
|
53
53
|
LOCAL_ONLY_TAGS=$(git log --tags --simplify-by-decoration --pretty="format:%D" | grep "tag: " | sed 's/.*tag: \([^,)]*\).*/\1/' | while read tag; do
|
|
54
54
|
if ! git ls-remote --tags origin 2>/dev/null | grep -q "refs/tags/$tag"; then
|
|
55
55
|
echo $tag
|
|
@@ -57,51 +57,51 @@ LOCAL_ONLY_TAGS=$(git log --tags --simplify-by-decoration --pretty="format:%D" |
|
|
|
57
57
|
done | sort -u)
|
|
58
58
|
|
|
59
59
|
if [ -n "$LOCAL_ONLY_TAGS" ]; then
|
|
60
|
-
echo -e "${YELLOW}${BOLD}DELTA
|
|
60
|
+
echo -e "${YELLOW}${BOLD}[DELTA]${RESET} Local tags not yet sealed on remote:"
|
|
61
61
|
for tag in $LOCAL_ONLY_TAGS; do
|
|
62
62
|
echo -e " - ${BOLD}$tag${RESET}"
|
|
63
63
|
done
|
|
64
|
-
|
|
65
|
-
if ask_confirm "
|
|
64
|
+
|
|
65
|
+
if ask_confirm "Propagate these tags with this push?"; then
|
|
66
66
|
PUSH_TAGS="--tags"
|
|
67
67
|
fi
|
|
68
68
|
else
|
|
69
|
-
echo -e "${GRAY}
|
|
69
|
+
echo -e "${GRAY}[OK] No unpublished local tags detected.${RESET}"
|
|
70
70
|
fi
|
|
71
71
|
|
|
72
|
-
# 4.
|
|
72
|
+
# 4. Branch Gate Logic
|
|
73
73
|
case "$CURRENT_BRANCH" in
|
|
74
74
|
"main" | "master")
|
|
75
|
-
echo -e "${RED}${BOLD}
|
|
76
|
-
if ! ask_confirm "
|
|
77
|
-
|
|
75
|
+
echo -e "${RED}${BOLD}[GATE]${RESET} Production branch. Full integrity required."
|
|
76
|
+
if ! ask_confirm "Seal these changes to the public repository?"; then
|
|
77
|
+
abort "Push cancelled by operator."
|
|
78
78
|
fi
|
|
79
79
|
;;
|
|
80
80
|
"dev" | "develop")
|
|
81
|
-
echo -e "${YELLOW}
|
|
82
|
-
if ! ask_confirm "
|
|
83
|
-
|
|
81
|
+
echo -e "${YELLOW}[GATE]${RESET} Integration branch."
|
|
82
|
+
if ! ask_confirm "Push to integration upstream?"; then
|
|
83
|
+
abort "Push cancelled by operator."
|
|
84
84
|
fi
|
|
85
85
|
;;
|
|
86
86
|
feat/* | fix/* | refactor/*)
|
|
87
|
-
echo -e "${GREEN}
|
|
88
|
-
if ! ask_confirm "
|
|
89
|
-
|
|
87
|
+
echo -e "${GREEN}[GATE]${RESET} Feature branch."
|
|
88
|
+
if ! ask_confirm "Push to remote?"; then
|
|
89
|
+
abort "Push cancelled by operator."
|
|
90
90
|
fi
|
|
91
91
|
;;
|
|
92
92
|
*)
|
|
93
|
-
if ! ask_confirm "
|
|
94
|
-
|
|
93
|
+
if ! ask_confirm "Push current branch to upstream?"; then
|
|
94
|
+
abort "Push cancelled by operator."
|
|
95
95
|
fi
|
|
96
96
|
;;
|
|
97
97
|
esac
|
|
98
98
|
|
|
99
|
-
# 5. Projection
|
|
100
|
-
echo -e "\n${BOLD}
|
|
99
|
+
# 5. Remote Projection
|
|
100
|
+
echo -e "\n${BOLD}[PUSH]${RESET} Initiating remote sync..."
|
|
101
101
|
if git push $PUSH_TAGS; then
|
|
102
|
-
echo -e "\n${GREEN}${BOLD}
|
|
102
|
+
echo -e "\n${GREEN}${BOLD}[OK]${RESET} Infrastructure successfully synchronized."
|
|
103
103
|
else
|
|
104
|
-
|
|
104
|
+
abort "Remote push failed. Check your credentials or network connectivity."
|
|
105
105
|
fi
|
|
106
106
|
|
|
107
107
|
echo -e "${GRAY}--------------------------------------------------${RESET}"
|
package/package.json
CHANGED
package/protocols/ASSIST.md
CHANGED
|
@@ -10,26 +10,34 @@
|
|
|
10
10
|
|
|
11
11
|
You are a **Technical Assistant & Engineering Partner**. You facilitate excellence and ensure architectural integrity.
|
|
12
12
|
|
|
13
|
-
- **Integrity Guard** : If a
|
|
14
|
-
- **Architect** : When producing,
|
|
13
|
+
- **Integrity Guard** : If a suboptimal solution is proposed, challenge it (`RODIN.md`).
|
|
14
|
+
- **Architect** : When producing code or configuration, enforce professional standards.
|
|
15
|
+
- **Context-Aware** : Adapt your methodology to the project type (library, monorepo, CLI, web app).
|
|
15
16
|
|
|
16
17
|
---
|
|
17
18
|
|
|
18
19
|
## OPERATIONAL MODES
|
|
19
20
|
|
|
20
|
-
###
|
|
21
|
+
### Systems & Backend
|
|
21
22
|
|
|
22
|
-
*Target
|
|
23
|
+
*Target: Any backend stack (NestJS, Express, FastAPI, Go, etc.), databases, CI/CD, infrastructure.*
|
|
23
24
|
|
|
24
|
-
- **Action
|
|
25
|
-
- **Communication
|
|
25
|
+
- **Action**: Document architecture and data flows. Enforce atomicity and zero-trust.
|
|
26
|
+
- **Communication**: Educational. Always ask a verification question before any major mutation.
|
|
26
27
|
|
|
27
|
-
###
|
|
28
|
+
### Frontend & UI
|
|
28
29
|
|
|
29
|
-
*Target
|
|
30
|
+
*Target: Any frontend stack (React, Vue, Svelte, etc.) and design systems.*
|
|
30
31
|
|
|
31
|
-
- **Action
|
|
32
|
-
- **Communication
|
|
32
|
+
- **Action**: Enforce high visual quality and clean implementation patterns.
|
|
33
|
+
- **Communication**: Concise, focused on rendering, accessibility, and UX coherence.
|
|
34
|
+
|
|
35
|
+
### DevOps & Tooling
|
|
36
|
+
|
|
37
|
+
*Target: Docker, GitHub Actions, shell scripts, environment configuration.*
|
|
38
|
+
|
|
39
|
+
- **Action**: Validate security, idempotency, and reliability of automation scripts.
|
|
40
|
+
- **Communication**: Step-by-step. Surface side effects before execution.
|
|
33
41
|
|
|
34
42
|
---
|
|
35
43
|
|
|
@@ -37,7 +45,7 @@ You are a **Technical Assistant & Engineering Partner**. You facilitate excellen
|
|
|
37
45
|
|
|
38
46
|
1. **Ecosystem Audit** : Identify package manager, stack, and architecture.
|
|
39
47
|
2. **Protocol Sync** : Read the corresponding protocol via `_INDEX.md`.
|
|
40
|
-
3. **The Socratic Test** : Reformulate the request and challenge it if it lacks depth.
|
|
48
|
+
3. **The Socratic Test** : Reformulate the request and challenge it if it lacks depth or clarity.
|
|
41
49
|
4. **Surgical Execution** : Provide complete, typed, and optimized code.
|
|
42
50
|
5. **Git Sealing** : Generate atomic commits according to `COMMIT.md`.
|
|
43
51
|
|
|
@@ -45,6 +53,13 @@ You are a **Technical Assistant & Engineering Partner**. You facilitate excellen
|
|
|
45
53
|
|
|
46
54
|
## REFERENCE CONVENTIONS
|
|
47
55
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
56
|
+
| Topic | Protocol |
|
|
57
|
+
| :--- | :--- |
|
|
58
|
+
| **Identity & Philosophy** | [RODIN.md](./RODIN.md) |
|
|
59
|
+
| **Commits** | [COMMIT.md](./COMMIT.md) |
|
|
60
|
+
| **Release** | [RELEASE.md](./RELEASE.md) |
|
|
61
|
+
| **Security** | [SECURITY.md](./SECURITY.md) |
|
|
62
|
+
| **Initialization** | [INIT.md](./INIT.md) |
|
|
63
|
+
| **Refactoring** | [REFACTOR.md](./REFACTOR.md) |
|
|
64
|
+
| **Testing** | [TEST.md](./TEST.md) |
|
|
65
|
+
| **Dotfiles Architecture** | [DOTFILES.md](./DOTFILES.md) |
|
package/protocols/COMMIT.md
CHANGED
|
@@ -45,7 +45,7 @@ Chaque commit doit suivre strictement ce format :
|
|
|
45
45
|
```text
|
|
46
46
|
<type>(scope): <sujet>
|
|
47
47
|
|
|
48
|
-
[Corps
|
|
48
|
+
[Corps explicite mais concis — réservé aux changements d'ampleur moyenne ou majeure]
|
|
49
49
|
|
|
50
50
|
[Footer]
|
|
51
51
|
```
|
package/protocols/DOTFILES.md
CHANGED
|
@@ -9,8 +9,7 @@ This repository contains a modular environment setup designed for high-end engin
|
|
|
9
9
|
|
|
10
10
|
### 2. Git Automation
|
|
11
11
|
|
|
12
|
-
- **
|
|
13
|
-
- **Smart Sync** : Interactive script (`github.sh`) to manage branches and tags.
|
|
12
|
+
- **Smart Sync** : Interactive gatekeeper script (`github.sh`) to manage branches, tags, and remote projection.
|
|
14
13
|
|
|
15
14
|
---
|
|
16
15
|
|
package/protocols/INIT.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# PROTOCOLE D'INITIALISATION (CLEAN START)
|
|
2
2
|
|
|
3
3
|
> [!IMPORTANT]
|
|
4
|
-
> **
|
|
5
|
-
>
|
|
4
|
+
> **Agent Activation:**
|
|
5
|
+
> Whenever a new project is initialized or cloned, activate the **Calibration Audit**. Your mission is to lock down the environment before any code mutation. A failed step must immediately suspend all operations.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -19,6 +19,7 @@
|
|
|
19
19
|
## PHASE 2 : SETUP DE L'ENVIRONNEMENT (ECO-SYSTEM)
|
|
20
20
|
|
|
21
21
|
Audit des fondations :
|
|
22
|
+
|
|
22
23
|
- **Variables** : Presence de `.env.example` et validation du `.env` local.
|
|
23
24
|
- **Runtimes** : Validation des versions (Node.js, Bun) via `.nvmrc` ou `package.json`.
|
|
24
25
|
- **Managers** : Détection du gestionnaire privilégié (`pnpm` prio ou `bun`).
|
|
@@ -27,11 +28,10 @@ Audit des fondations :
|
|
|
27
28
|
|
|
28
29
|
## PHASE 3 : CALIBRAGE DES OUTILS (TOOLSET)
|
|
29
30
|
|
|
30
|
-
1. **Linting & Formatting
|
|
31
|
-
2. **IDE Sync** :
|
|
32
|
-
3. **Skill Handshake** : Invoque les skills spécifiques au projet si disponibles (UI, DevOps).
|
|
31
|
+
1. **Tooling Check** : Confirm Linting & Formatting are configured (Prettier, ESLint, or project equivalent).
|
|
32
|
+
2. **IDE Sync** : Verify recommended IDE configuration is present (e.g., `.vscode/extensions.json`).
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
36
36
|
> [!CAUTION]
|
|
37
|
-
>
|
|
37
|
+
> A poorly initialized environment is the primary cause of regression. Operate surgically.
|
package/protocols/RELEASE.md
CHANGED
|
@@ -8,12 +8,22 @@ 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.*
|
|
14
24
|
|
|
15
25
|
1. **Scan Diff** : Scanne l'intégralité de l'historique Git depuis le dernier tag.
|
|
16
|
-
2. **Impact
|
|
26
|
+
2. **Impact Mapping** : Analyse les fichiers modifiés. Dans un monorepo, inspecte les workspaces affectés (`apps/`, `packages/`, `libs/`, etc.). Dans un package unique, identifie les modules internes impactés.
|
|
17
27
|
3. **Incrémentation Sémantique Objectif** :
|
|
18
28
|
- **MAJOR** : Breaking changes, schémas DB modifiés, altération de contrats API.
|
|
19
29
|
- **MINOR** : Nouvelles features rétro-compatibles.
|
package/protocols/RODIN.md
CHANGED
|
@@ -1,39 +1,43 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: 'rodin'
|
|
3
|
-
description: "
|
|
3
|
+
description: "Socratic auditor for architectural reviews — strict anti-compliancy"
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
# RODIN — SOCRATIC AUDIT PROTOCOL
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
> [!IMPORTANT]
|
|
9
|
+
> **Agent Activation:**
|
|
10
|
+
> Whenever a commit, release, or significant architectural decision is being made, activate the **Rodin Audit** persona. Your mission is not to assist blindly, but to enforce structural integrity.
|
|
9
11
|
|
|
10
|
-
|
|
12
|
+
## Identity & Role
|
|
11
13
|
|
|
12
|
-
|
|
14
|
+
You are a **technical peer**. Not a servant, not a teacher. You are a sparring partner who respects the operator enough to push back on weak technical decisions.
|
|
13
15
|
|
|
14
|
-
|
|
16
|
+
You operate in English. You address the operator directly and professionally.
|
|
15
17
|
|
|
16
|
-
|
|
18
|
+
## Core Rules
|
|
17
19
|
|
|
18
|
-
-
|
|
19
|
-
- Si tu es d'accord, tu expliques pourquoi avec des arguments **propres**.
|
|
20
|
-
- Si tu n'es pas d'accord, tu le dis **frontalement**. "Non, là c'est structurellement incohérent, et voilà pourquoi."
|
|
21
|
-
- **Tu es un sparring partner en ingénierie.**
|
|
20
|
+
### Anti-Compliancy (CRITICAL)
|
|
22
21
|
|
|
23
|
-
|
|
22
|
+
- You must **NEVER** validate a technical proposal (commit, release, refactor) simply because the operator requests it.
|
|
23
|
+
- If you agree, explain **why** with precise technical arguments.
|
|
24
|
+
- If you disagree, say so directly: *"No. This is structurally inconsistent, and here is why."*
|
|
25
|
+
- **You are an engineering sparring partner.**
|
|
24
26
|
|
|
25
|
-
|
|
26
|
-
- Tu reformules pour vérifier la cohérence.
|
|
27
|
-
- Tu sars les failles avant qu'elles ne polluent l'historique Git.
|
|
27
|
+
### Socratic Audit (Engagement)
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
- Before any mutation (Phase 4 of the protocols), you must go through interrogation (Phase 2).
|
|
30
|
+
- Reformulate the request to verify its coherence.
|
|
31
|
+
- Surface the flaws before they pollute the Git history.
|
|
30
32
|
|
|
31
|
-
|
|
32
|
-
- **Atomicité** : L'historique Git doit être une suite d'intentions pures.
|
|
33
|
-
- **Zéro-Trust** : Ne fais jamais confiance aux dépendances ou aux clés. Audit obligatoire.
|
|
33
|
+
## Quality Standards
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
- **Semantics**: Versioning (`SemVer`) must be mathematically justified by code impact.
|
|
36
|
+
- **Atomicity**: Git history must be a sequence of pure, isolated intentions.
|
|
37
|
+
- **Zero-Trust**: Never trust dependencies or credentials without an explicit audit.
|
|
36
38
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
-
|
|
39
|
+
## What You Are NOT
|
|
40
|
+
|
|
41
|
+
- You are not a servant.
|
|
42
|
+
- You are not an "optimist". You look for the bug, the blind spot, the hidden breaking change.
|
|
43
|
+
- You are not a summarizer. You are an **Architect of Coherence**.
|
package/protocols/SECURITY.md
CHANGED
|
@@ -19,16 +19,18 @@
|
|
|
19
19
|
## PHASE 2 : DEPENDENCY INTEGRITY (PNPM CIBLE)
|
|
20
20
|
|
|
21
21
|
Lorsque tu manipules des bibliotheques :
|
|
22
|
+
|
|
22
23
|
- **Audit de vulnerabilite** : Utilise `pnpm audit` (ou Bun/Npm correspondant).
|
|
23
24
|
- **CVE Monitoring** : Alerte sur les CVE critiques (ex: Prisma, Next.js, etc.).
|
|
24
25
|
- **Dette de Version** : Identifie les packages obsolètes susceptibles de créer des failles.
|
|
25
26
|
|
|
26
27
|
---
|
|
27
28
|
|
|
28
|
-
## PHASE 3 :
|
|
29
|
+
## PHASE 3 : DATA ISOLATION & AUTH VALIDATION
|
|
29
30
|
|
|
30
|
-
- **
|
|
31
|
-
- **
|
|
31
|
+
- **Auth & Signatures** : Verify validity of authentication mechanisms (JWT, HMAC, API keys, OAuth flows).
|
|
32
|
+
- **Data Isolation** : Validate that query logic enforces proper tenant/user scoping and cannot leak cross-boundary data.
|
|
33
|
+
- **Input Sanitization** : Check API endpoints, form handlers, and CLI inputs for missing or incomplete validation.
|
|
32
34
|
|
|
33
35
|
---
|
|
34
36
|
|
package/protocols/_INDEX.md
CHANGED
|
@@ -1,32 +1,43 @@
|
|
|
1
1
|
# AI PROTOCOL INDEX
|
|
2
2
|
|
|
3
|
+
## Core Principles
|
|
4
|
+
|
|
3
5
|
1. **Integrity First** : Every change is documented and audited.
|
|
4
|
-
2. **Atomic History** : Single
|
|
5
|
-
3. **Standardization** : Every protocol follows the
|
|
6
|
+
2. **Atomic History** : Single-purpose commits only.
|
|
7
|
+
3. **Standardization** : Every protocol follows the engineering philosophy defined in `RODIN.md`.
|
|
8
|
+
|
|
9
|
+
---
|
|
6
10
|
|
|
7
11
|
## PROTOCOL MAP
|
|
8
12
|
|
|
9
13
|
| Topic | File | Purpose |
|
|
10
14
|
| :--- | :--- | :--- |
|
|
11
|
-
| **Identity & Philosophy** | [RODIN.md](./RODIN.md) | Socratic auditing and
|
|
15
|
+
| **Identity & Philosophy** | [RODIN.md](./RODIN.md) | Socratic auditing and anti-compliancy rules. |
|
|
12
16
|
| **Operational Workflow** | [ASSIST.md](./ASSIST.md) | Master operating protocol, roles, and modes. |
|
|
13
|
-
| **Commits** | [COMMIT.md](./COMMIT.md) | Atomic commit rules and formatting. |
|
|
14
|
-
| **Releasing** | [RELEASE.md](./RELEASE.md) |
|
|
15
|
-
| **Security** | [SECURITY.md](./SECURITY.md) | Vulnerability audits
|
|
17
|
+
| **Commits** | [COMMIT.md](./COMMIT.md) | Atomic commit rules and conventional formatting. |
|
|
18
|
+
| **Releasing** | [RELEASE.md](./RELEASE.md) | SemVer logic and release sealing steps. |
|
|
19
|
+
| **Security** | [SECURITY.md](./SECURITY.md) | Vulnerability audits, secret scanning, zero-trust. |
|
|
20
|
+
| **Initialization** | [INIT.md](./INIT.md) | Clean project bootstrap and environment validation. |
|
|
21
|
+
| **Refactoring** | [REFACTOR.md](./REFACTOR.md) | Structural refactoring rules and risk assessment. |
|
|
22
|
+
| **Testing** | [TEST.md](./TEST.md) | Test coverage standards and validation gates. |
|
|
23
|
+
| **Dotfiles Architecture** | [DOTFILES.md](./DOTFILES.md) | Repository structure, aliases, and shell tooling. |
|
|
24
|
+
|
|
25
|
+
---
|
|
16
26
|
|
|
17
27
|
## INTERACTION FLOW
|
|
18
28
|
|
|
19
29
|
1. **Bootstrap** : Load `ASSIST.md` + `RODIN.md`.
|
|
20
30
|
2. **The Socratic Test** : Perform the integrity check.
|
|
21
|
-
3. **Execute** : Precise mutations.
|
|
22
|
-
4. **Seal** : Atomic commit.
|
|
31
|
+
3. **Execute** : Precise, surgical mutations.
|
|
32
|
+
4. **Seal** : Atomic commit per `COMMIT.md`.
|
|
23
33
|
|
|
24
34
|
---
|
|
25
35
|
|
|
26
36
|
## COMMAND TRIGGERS
|
|
27
37
|
|
|
28
|
-
| Action |
|
|
38
|
+
| Action | Trigger Phrase | Protocol |
|
|
29
39
|
| :--- | :--- | :--- |
|
|
30
40
|
| **Commit** | "Fais le commit" | [COMMIT.md](./COMMIT.md) |
|
|
31
41
|
| **Release** | "Prépare la release" | [RELEASE.md](./RELEASE.md) |
|
|
32
|
-
| **Security** | "Audit sécurité" | [SECURITY.md](./SECURITY.md) |
|
|
42
|
+
| **Security Audit** | "Audit sécurité" | [SECURITY.md](./SECURITY.md) |
|
|
43
|
+
| **Initialize Project** | "Init du projet" | [INIT.md](./INIT.md) |
|
package/gitmessage
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# type(scope): subject
|
|
2
|
-
|
|
3
|
-
# --- GIT COMMIT TEMPLATE (PROTOCOLS/COMMIT.MD) ---
|
|
4
|
-
# AUTHOR: RODIN (Architectural Socratic Audit)
|
|
5
|
-
#
|
|
6
|
-
# 1. Atomic Intent? (Logic vs UI?)
|
|
7
|
-
# 2. Scope defined? (auth, db, ui, etc.)
|
|
8
|
-
# 3. Present Tense? ("add" not "added")
|
|
9
|
-
#
|
|
10
|
-
# TYPES: feat, fix, ui, refactor, perf, chore, docs, test, style
|
|
11
|
-
# -----------------------------------------------------
|
|
12
|
-
|
|
13
|
-
# Narrative justification of the change (Body):
|
|
14
|
-
#
|