@wistantkode/dotfiles 1.5.0 → 1.7.0

package/CHANGELOG.md

@@ -2,9 +2,33 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.7.0] - 2026-04-05 - [High-Fidelity Orchestration & Logic Refinement]
+
+### Added
+
+- **High-Fidelity UI**: Block progress bars (`█`) and CYAN/YELLOW color accents for a premium feel.
+- **Branded Signature**: Integrated an interactive authorship and source information table.
+- **Enhanced Orchestration**: Two-stage directory confirmation and state-aware audit feedback.
+- **Protocol Governance**: Logic refinement for `.protocols/` folder selection with architectural recommendations.
+
+## [1.6.0] - 2026-04-05 - [Vellum & Void Integrity]
+
+### Added
+
+- **Formal Governance**: Integrated professional `CONTRIBUTING.md` and `SECURITY.md` root-level guides, transitioning from internal metaphors to standard engineering contracts.
+- **Community Infrastructure**: Added a dedicated Community section with a high-fidelity contributor avatar grid and refined attribution.
+
+### Changed
+
+- **Architectural Mapping**: Migrated the CLI entry point from `bin/` to `cli/` to align with modern package distribution standards.
+- **Technical Sanitization**: Purged all metaphorical terminology (Rodin, Socratic, Audit) from public-facing documentation in favor of professional engineering nomenclature.
+- **Visual Engineering**: Redesigned the `README.md` signature header and updated the technical verification workflow diagram (Mermaid).
+- **Hardening**: Refined the implementation of Zero-Trust principles in the root security policy.
+
 ## [1.5.0] - 2026-04-05 - [Iron Gate & Neon Dash]
 
 ### Added
+
 - **Protocol Hardening**: Integrated strict "Zero-Initiative" and "Separation of Concerns" rules into `RODIN.md` and `COMMIT.md`. AI is now formally forbidden from touching release artifacts outside of Release mode.
 - **Elite UI Overhaul**: Complete refactor of `github.sh` and `bin/cli.mjs` with premium 256-color aesthetics, box-drawing tables, and animated progress bars.
 - **Enhanced Gatekeeping**: `github.sh` now performs a silent tag-delta audit and forces manual confirmation on production branches.

package/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to Dotfiles Infrastructure
+
+This repository is governed by strict **Architectural Validation**. To maintain technical excellence, every contribution must align with our core engineering baseline. Precision and structural integrity are non-negotiable.
+
+---
+
+## ⚡ Technical Pillars
+
+### 1. Atomic Integrity
+
+We maintain a linear, pure history. PRs must represent a single, isolated logical intention.
+
+- **Manual Staging**: The use of `git add .` is prohibited. Every staging must be targeted (`git add <file>`).
+- **No Hybrid Commits**: Do not mix refactoring (`refactor`) with functional additions (`feat`) in the same commit.
+- **Separation of Powers**: Release manifests (`package.json`, `CHANGELOG.md`) and Git Tags are strictly reserved for the **Release Protocol**. They must never be part of a standard code commit.
+
+### 2. Architectural Governance
+
+Your interaction with the codebase is a technical review, not a service.
+
+- **Critical Assessment**: Contributors (Human or AI) must provide technical justification for every change. Blind validation is a protocol failure.
+- **Zero-Initiative**: Decision-making is limited to the explicit scope of the requested task. Unauthorized modification of non-cited components is forbidden.
+- **Impact-Based SemVer**: Versioning must be mathematically justified by the code impact analyzed during the release phase.
+
+### 3. AI-Pairing Standards
+
+We recognize AI as a technical peer. Contributions co-authored by an agent must:
+
+- Maintain a direct, technical, and objective tone.
+- Be verified by the **Architect (Human)** at every execution gate.
+- **The Verification Barrier**: The agent must prompt for human confirmation of the versioning logic before final execution.
+
+---
+
+## Development Lifecycle
+
+### Phase 1: Code Implementation
+
+Follow the **Commit Convention**. Use strict prefixes (`feat`, `fix`, `refactor`, `style`, `ui`, `docs`).
+
+### Phase 2: Infrastructure Deployment
+
+Deployment follows the **Architectural Release** flow. Every release must be sealed with a unique identifier: `vX.Y.Z - [MOTTO]`.
+
+---
+
+## 👥 Maintenance
+
+Managed by **Wistant** — Lead Architect.
+
+---

package/README.md

@@ -1,64 +1,61 @@
-# [@wistantkode/dotfiles](https://www.npmjs.com/package/@wistantkode/dotfiles)
-
 <div align="center">
-  <table border="0" cellpadding="0" cellspacing="0">
-    <tr>
-      <td align="center" valign="middle">
-        <img src="./assets/wistant-logo.png" alt="Wistant Logo" width="100" />
-      </td>
-      <td align="center" valign="middle" style="padding: 0 40px;">
-        <img src="./assets/memoji.png" alt="Memoji" width="120" />
-      </td>
-      <td align="center" valign="middle">
-        <img src="./assets/dotfiles.png" alt="Dotfiles Logo" width="100" />
-      </td>
-    </tr>
-  </table>
-  <br />
-  <p><b>Precision AI-Pairing Infrastructure & Architectural Protocols</b></p>
-  
+  <img src="./assets/logo.png" alt="Dotfiles Logo" width="240" />
+
+# Precision Dotfiles Infrastructure
+
+  [ Automated Orchestration • AI-Driven Logic • System Governance • CLI Distribution ]
+
   <p>
+    <a href="https://pnpm.io">
+       <img src="https://img.shields.io/badge/pnpm-4AB6FA?style=for-the-badge&logo=pnpm&logoColor=white" alt="pnpm" />
+    </a>
+    <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript">
+       <img src="https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black" alt="javascript" />
+    </a>
     <a href="https://www.npmjs.com/package/@wistantkode/dotfiles">
-      <img src="https://img.shields.io/npm/v/@wistantkode/dotfiles?style=for-the-badge&color=CC0000&logo=npm" alt="npm version" />
+       <img src="https://img.shields.io/badge/npm-CB3837?style=for-the-badge&logo=npm&logoColor=white" alt="npm" />
     </a>
-    <a href="https://pnpm.io">
-      <img src="https://img.shields.io/badge/pnpm-4AB6FA?style=for-the-badge&logo=pnpm&logoColor=white" alt="pnpm" />
+    <a href="https://github.com/wistant/dotfiles/actions">
+       <img src="https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge&logo=github-actions&logoColor=white" alt="github actions" />
     </a>
-    <a href="./LICENSE">
-      <img src="https://img.shields.io/badge/License-Apache_2.0-F47023?style=for-the-badge" alt="License" />
+    <a href="https://github.com/wistant/dotfiles/releases">
+       <img src="https://img.shields.io/badge/Release-v1.7.0-blue?style=for-the-badge&logo=github" alt="GitHub release" />
     </a>
   </p>
+
 </div>
 
 ---
 
-## Infrastructure Orchestration
-
-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.
-
-### The System Advantage
-
-- **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.
-- **Atomic Reliability**: Every modification is routed through a verification cycle that prevents history pollution and mixed intentions.
-- **Universal Staging**: Powered by **pnpm**, **JavaScript (ESM)**, and **Shell orchestration**, the entire ecosystem is instantly deployable via `npx` or `pnpm dlx`.
-
----
+## Architectural Orchestration
 
-## Operational Workflow
+This repository is not just a collection of configs; it is a **Living Governance System**. Every interaction between the Architect and the AI is filtered through a rigorous protocol stack.
 
 ```mermaid
-graph TD
-    A[Socratic AI-Pairing] -- Atomic Audit --> B[Local Commit Sequence]
-    B -- github.sh Gatekeeper --> C[GitHub Mirror]
-    C -- Automated CI/CD --> D[GitHub Actions]
-    D -- Security & Distribution --> E[NPM Global Registry]
-    F[Remote Deployment] -- pnpm dlx --> E
+graph LR
+    subgraph "Engineering & Governance"
+        SE[Software Engineer] --> PR[Protocols & Registry]
+    end
+
+    subgraph "Automation Core"
+        PR --> CLI[CLI Orchestrator]
+        PR --> SYNC[Sync Engine]
+    end
+
+    subgraph "Deployment Lifecycle"
+        CLI --> OS[System Deployment]
+        SYNC --> GIT[Git Integrity]
+        GIT --> NPM[NPM Distribution]
+    end
+
+    style SE fill:#fff,stroke:#333,stroke-width:2px
+    style NPM fill:#000,stroke:#fff,stroke-width:2px,color:#fff
 ```
 
 ### Core Automation Tools
 
 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.
-2. **System Protocols**: A library of hidden guides that force the AI to maintain professional standards (Atomic commits, Socratic releases, Security first).
+2. **System Protocols**: A library of hidden guides that force the AI to maintain professional standards (Atomic commits, Protocol releases, Security first).
 3. **Automated Distribution**: GitHub Actions handle the security auditing and global NPM publication upon Every GitHub Release.
 
 ---
@@ -72,6 +69,7 @@ pnpm dlx @wistantkode/dotfiles
 ```
 
 ### Included Assets
+
 - **Professional `.gitignore`**: PRODUCTION-READY baseline for all modern stacks.
 - **Security & Integrity**: Injected `.protocols/` folder for immediate AI alignment.
 - **Universal License**: Apache 2.0 baseline for all technical distributions.
@@ -82,21 +80,36 @@ pnpm dlx @wistantkode/dotfiles
 
 | Standard | Role | Reference |
 | :--- | :--- | :--- |
-| **Audit Philosophy** | Socratic auditing and architectural integrity. | [RODIN.md](./protocols/RODIN.md) |
+| **Audit Philosophy** | Protocol auditing and architectural integrity. | [RODIN.md](./protocols/RODIN.md) |
 | **Commit Protocol** | Strict atomic formatting and zero-entropy staging. | [COMMIT.md](./protocols/COMMIT.md) |
-| **Release Flow** | Socratic versioning and manual sealing logic. | [RELEASE.md](./protocols/RELEASE.md) |
+| **Release Flow** | Technical versioning and manual sealing logic. | [RELEASE.md](./protocols/RELEASE.md) |
 | **Security First** | Vulnerability audits and secret scanning protocols. | [SECURITY.md](./protocols/SECURITY.md) |
 
 > See [_INDEX.md](./protocols/_INDEX.md) for the full library of orchestration protocols.
 
 ---
 
+## Contributors
+
+The project is currently orchestrated by its lead software engineer. New contributions are welcome to expand the baseline.
+
+<p align="left">
+  <a href="https://github.com/wistant">
+    <img src="https://github.com/wistant.png?size=100" width="50" height="50" alt="wistant" title="Wistant"/>
+  </a>
+</p>
+
+---
+
+## Community
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to join the **contributors** and submit PRs.
+AI/vibe-coded PRs welcome! 🤖
+
+---
+
 ## License
 
 Copyright © 2026 **Wistant**. Distributed under the **Apache License 2.0**.
 
 ---
-
-<div align="center">
-  <p>Engineered for professional AI-Pairing by <b>@wistantkode</b></p>
-</div>

package/SECURITY.md

@@ -0,0 +1,39 @@
+# Security Policy
+
+This repository follows a **Zero-Trust** security model. We prioritize the integrity of the infrastructure and the protection of sensitive architectural data.
+
+## Supported Versions
+
+We only provide security updates for the current major version.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| v1.x    | :white_check_mark: |
+| < v1.0  | :x:                |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please do NOT open a public issue. We take security seriously and prefer a coordinated disclosure.
+
+Please report vulnerabilities directly to the maintainer:
+- **Contact**: [@wistant](https://github.com/wistant)
+- **Encryption**: If possible, encrypt your report using a secure channel.
+
+## Our Security Principles
+
+### 1. Silent Guardian Audit
+Every interaction with the codebase (commits, refactors, releases) triggers a scan for:
+- Exposed secrets (tokens, API keys, private keys).
+- Context leaks (internal paths, IPs, machine names).
+- Insecure API logic or missing sanitization.
+
+### 2. Dependency Integrity
+We use strictly audited dependencies. 
+- All packages are scanned via `pnpm audit`.
+- Critical CVEs in core libraries results in an immediate suspension of the release flow until resolved.
+
+### 3. Isolation by Design
+Sensitive configuration files and release manifests are strictly isolated from the standard development cycle to prevent accidental leakage.
+
+---
+**Architectural Integrity • Security First • @wistant dotfiles baseline**

package/cli/cli.mjs

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+/**
+ * ═══════════════════════════════════════════════════════════════════════
+ *   DOTFILES INSTALLER  ·  Elite Orchestration  ·  @wistantkode/dotfiles
+ * ════════════════════════════════════════───────────────────────════════
+ */
+
+import { copyFile, mkdir, readdir, lstat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createInterface } from 'node:readline/promises';
+
+// ── UI Configuration (256-color) ──────────────────────────────────────
+const RESET    = '\x1b[0m';
+const BOLD     = '\x1b[1m';
+const DIM      = '\x1b[2m';
+const CYAN     = '\x1b[38;5;117m';
+const GREEN    = '\x1b[38;5;114m';
+const YELLOW   = '\x1b[38;5;221m';
+const RED      = '\x1b[38;5;203m';
+const GRAY     = '\x1b[38;5;244m';
+const WHITE    = '\x1b[38;5;255m';
+const DGRAY    = '\x1b[38;5;238m';
+const BLUE     = '\x1b[38;5;75m';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(__dirname, '..');
+
+// ── Layout Components ─────────────────────────────────────────────────
+
+const _rep = (n, char = ' ') => char.repeat(Math.max(0, n));
+const sep = () => console.log(`${DGRAY}${_rep(64, '─')}${RESET}`);
+
+const renderLogo = () => {
+  // Ultra-High-Fidelity "Full Block" Style
+  console.log(`\n  ${CYAN}██████╗  ██████╗ ████████╗███████╗██╗██╗     ███████╗███████╗`);
+  console.log(`  ${CYAN}██╔══██╗██╔═══██╗╚══██╔══╝██╔════╝██║██║     ██╔════╝██╔════╝`);
+  console.log(`  ${CYAN}██║  ██║██║   ██║   ██║   █████╗  ██║██║     █████╗  ███████╗`);
+  console.log(`  ${CYAN}██║  ██║██║   ██║   ██║   ██╔══╝  ██║██║     ██╔══╝  ╚════██║`);
+  console.log(`  ${CYAN}██████╔╝╚██████╔╝   ██║   ██║     ██║███████╗███████╗███████║`);
+  console.log(`  ${CYAN}╚═════╝  ╚═════╝    ╚═╝   ╚═╝     ╚═╝╚══════╝╚══════╝╚══════╝${RESET}`);
+  console.log(`\n  ${GRAY}${BOLD}[ PRECISION AI ORCHESTRATION ]${RESET}\n`);
+};
+
+const progress = async (label) => {
+  process.stdout.write(`  ${GRAY}[${RESET}`);
+  for (let i = 0; i < 28; i++) {
+    process.stdout.write(`${CYAN}█${RESET}`);
+    await new Promise(r => setTimeout(r, 10));
+  }
+  process.stdout.write(`${GRAY}]${RESET}  ${GREEN}${label}${RESET}\n`);
+};
+
+const renderSignature = () => {
+  const width = 44;
+  const stripAnsi = (str) => str.replace(/\x1b\[[0-9;]*m/g, '');
+  const pad = (text, len) => text + _rep(len - stripAnsi(text).length);
+
+  console.log(`\n  ${WHITE}${BOLD}SOURCE & AUTHORSHIP${RESET}`);
+  console.log(`  ${DGRAY}┌${_rep(width, '──')}┐${RESET}`);
+  
+  const label = (txt, col) => `${col}${BOLD}${txt}${RESET}`;
+
+  console.log(`  ${DGRAY}│${RESET}  ${pad(`${label('REPOSITORY', BLUE)}  ${BOLD}https://github.com/wistant/dotfiles${RESET}`, width + 17)} ${DGRAY}│${RESET}`);
+  console.log(`  ${DGRAY}├${_rep(width, '──')}┤${RESET}`);
+  console.log(`  ${DGRAY}│${RESET}  ${pad(`${label('ARCHITECT ', WHITE)}  ${BOLD}Wistant${RESET} ${GRAY}(DevOps Architect)${RESET}`, width + 28)} ${DGRAY}│${RESET}`);
+  console.log(`  ${DGRAY}│${RESET}  ${pad(`${label('GITHUB    ', BLUE)}  ${GRAY}https://github.com/wistant${RESET}`, width + 26)} ${DGRAY}│${RESET}`);
+  console.log(`  ${DGRAY}└${_rep(width, '──')}┘${RESET}\n`);
+};
+
+// ── Interactive Logic ─────────────────────────────────────────────────
+
+const rl = createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+const ask = async (question, defaultYes = true) => {
+  const options = defaultYes ? ' (Y/n)' : ' (y/N)';
+  const answer = await rl.question(`  ${YELLOW}${BOLD}?${RESET}  ${question}${GRAY}${options}${RESET}  `);
+  if (!answer) return defaultYes;
+  return answer.toLowerCase().startsWith('y');
+};
+
+async function checkDirectory(dir) {
+  try {
+    const files = await readdir(dir);
+    // Ignore common development/system noise
+    const filtered = files.filter(f => !['.git', 'node_modules', '.DS_Store', 'package-lock.json', 'pnpm-lock.yaml'].includes(f));
+    return filtered.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+// ── Core Engine ───────────────────────────────────────────────────────
+
+async function copyRecursive(src, dest, onFile) {
+  const stat = await lstat(src);
+  if (stat.isDirectory()) {
+    await mkdir(dest, { recursive: true });
+    const children = await readdir(src);
+    for (const child of children) {
+      await copyRecursive(join(src, child), join(dest, child), onFile);
+    }
+  } else {
+    await copyFile(src, dest);
+    if (onFile) onFile(dest);
+  }
+}
+
+async function run() {
+  process.stdout.write('\x1Bc'); // Clear screen
+  renderLogo();
+  sep();
+
+  const targetDir = process.cwd();
+  console.log(`\n  ${GRAY}System Target:${RESET}  ${WHITE}${BOLD}${targetDir}${RESET}`);
+  
+  const proceedTarget = await ask('Initiate deployment in this directory?', true);
+  if (!proceedTarget) {
+    console.log(`\n  ${RED}Deployment cancelled by user.${RESET}\n`);
+    rl.close();
+    return;
+  }
+
+  // Phase 1: Directory Audit
+  const isEmpty = !(await checkDirectory(targetDir));
+  if (isEmpty) {
+    console.log(`  ${GREEN}${BOLD}✔  TARGET DIRECTORY IS CLEAN${RESET}`);
+  } else {
+    console.log(`  ${YELLOW}${BOLD}⚠  TARGET DIRECTORY IS NOT EMPTY${RESET}`);
+    const proceed = await ask('Deployment may overwrite existing files. Force installation?', false);
+    if (!proceed) {
+      console.log(`\n  ${RED}Deployment cancelled by user.${RESET}\n`);
+      rl.close();
+      return;
+    }
+  }
+
+  // Phase 2: Protocol Selection
+  let protocolDest = '.protocols';
+  console.log(`\n  ${CYAN}${BOLD}i  GOVERNANCE PLACEMENT${RESET}`);
+  const useDotDir = await ask('Deploy protocols to .protocols/ folder? (Recommended)', true);
+  if (!useDotDir) {
+    protocolDest = 'protocols';
+    console.log(`  ${DIM}Protocols will be deployed to 'protocols/' (Visibility Mode).${RESET}`);
+  } else {
+    console.log(`  ${DIM}Protocols will be deployed to '.protocols/' (Architecture Standard).${RESET}`);
+  }
+
+  const ASSETS = [
+    { src: 'gitignore', dest: '.gitignore', label: 'Ignore patterns' },
+    { src: 'LICENSE', dest: 'LICENSE', label: 'License' },
+    { src: 'protocols', dest: protocolDest, label: 'Governance protocols', isDir: true }
+  ];
+
+  sep();
+  console.log(`\n  ${BOLD}▶  Ready to initiate deployment sequence...${RESET}`);
+  const confirm = await ask('Apply changes to your system?', true);
+  if (!confirm) {
+    console.log(`\n  ${RED}Deployment aborted.${RESET}\n`);
+    rl.close();
+    return;
+  }
+
+  console.log('');
+  await progress('Validating package integrity');
+
+  const deployedFiles = [];
+
+  for (const asset of ASSETS) {
+    try {
+      const srcPath = join(pkgRoot, asset.src);
+      const destPath = join(targetDir, asset.dest);
+      
+      if (asset.isDir) {
+        await copyRecursive(srcPath, destPath, (f) => {
+           deployedFiles.push(f.replace(targetDir, ''));
+        });
+      } else {
+        await copyFile(srcPath, destPath);
+        deployedFiles.push('/' + asset.dest);
+      }
+    } catch (err) {
+      console.error(`      ${RED}✘${RESET}  Failed to deploy ${asset.src}: ${err.message}`);
+    }
+  }
+
+  await progress('Finalizing system orchestration');
+
+  // Detailed Audit Logs
+  console.log(`\n  ${BOLD}DEPLOYMENT AUDIT${RESET}`);
+  console.log(`  ${DGRAY}${_rep(45, '─')}${RESET}`);
+  for (const file of deployedFiles.sort()) {
+    console.log(`    ${GREEN}✔${RESET}  ${GRAY}${file}${RESET}`);
+  }
+  console.log(`  ${DGRAY}${_rep(45, '─')}${RESET}`);
+
+  console.log(`\n  ${GREEN}${BOLD}✔  INFRASTRUCTURE DEPLOYED SUCCESSFULLY.${RESET}`);
+  console.log(`  ${GRAY}Your environment is now optimized for professional AI pairing.${RESET}`);
+
+  renderSignature();
+  
+  console.log(`  ${DIM}Thank you for choosing high-end architectural standards.${RESET}\n`);
+  sep();
+  console.log('');
+  
+  rl.close();
+}
+
+run().catch(err => {
+  console.error(`\n  ${RED}${BOLD}✗  FATAL ERROR${RESET}  ${err.message}\n`);
+  if (rl) rl.close();
+  process.exit(1);
+});

package/github.sh

@@ -2,13 +2,13 @@
 
 # ═══════════════════════════════════════════════════════════════════════
 #   GITHUB SYNC  ·  Integrity Gate  ·  @wistantkode/dotfiles
-# ═══════════════════════════════════════════════════════════════════════
+# ════════════════════════════════════════───────────────────────════════
 
-# ── Color palette (256-color) ─────────────────────────────────────────
+# ── Color palette (Minimalist 256-color) ──────────────────────────────
 RESET='\033[0m';    BOLD='\033[1m';     DIM='\033[2m'
-RED='\033[38;5;203m';   GREEN='\033[38;5;114m';  YELLOW='\033[38;5;221m'
-CYAN='\033[38;5;117m';  BLUE='\033[38;5;75m';    GRAY='\033[38;5;244m'
-DGRAY='\033[38;5;238m'; WHITE='\033[38;5;255m';  ORANGE='\033[38;5;215m'
+WHITE='\033[38;5;255m';  GRAY='\033[38;5;244m';   DGRAY='\033[38;5;238m'
+RED='\033[38;5;203m';    GREEN='\033[38;5;114m';  YELLOW='\033[38;5;221m'
+BLUE='\033[38;5;75m';    CYAN='\033[38;5;117m'
 
 # ── Table dimensions ──────────────────────────────────────────────────
 HASH_W=8    # hash column display width
@@ -16,13 +16,21 @@ MSG_W=52    # message column display width
 
 # ── Layout helpers ────────────────────────────────────────────────────
 _rep() { printf "%${1}s" | tr ' ' "${2}"; }
-_sep()  { echo -e "${DGRAY}$(_rep 68 '─')${RESET}"; }
-_sep2() { echo -e "${DGRAY}  $(_rep 64 '·')${RESET}"; }
+_sep()  { echo -e "${DGRAY}$(_rep 66 '─')${RESET}"; }
+
+_logo() {
+    echo -e "\n  ${WHITE}██████╗ ██╗████████╗██╗  ██╗██╗   ██╗██████╗ "
+    echo -e "  ${WHITE}██╔════╝ ██║╚══██╔══╝██║  ██║██║   ██║██╔══██╗"
+    echo -e "  ${WHITE}██║  ███╗██║   ██║   ███████║██║   ██║██████╔╝"
+    echo -e "  ${WHITE}██║   ██║██║   ██║   ██╔══██║██║   ██║██╔══██╗"
+    echo -e "  ${WHITE}╚██████╔╝██║   ██║   ██║  ██║╚██████╔╝██████╔╝"
+    echo -e "  ${WHITE} ╚═════╝ ╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ${RESET}"
+    echo -e "\n  ${GRAY}${BOLD}[ GITHUB AUTOMATION SYNC ]${RESET}\n"
+}
 
 _header() {
-    echo -e "${DGRAY}  ╭$(_rep $((HASH_W+2)) '─')┬$(_rep $((MSG_W+2)) '─')╮${RESET}"
-    printf "${DGRAY}  │${RESET}  ${BOLD}${GRAY}%-${HASH_W}s${RESET}  ${DGRAY}│${RESET}  ${BOLD}${GRAY}%-${MSG_W}s${RESET}  ${DGRAY}│${RESET}\n" "HASH" "COMMIT"
-    echo -e "${DGRAY}  ├$(_rep $((HASH_W+2)) '─')┼$(_rep $((MSG_W+2)) '─')┤${RESET}"
+    printf "  ${BOLD}${GRAY}%-${HASH_W}s   %-${MSG_W}s${RESET}\n" "HASH" "COMMIT MESSAGE"
+    _sep
 }
 
 _row() {
@@ -31,23 +39,17 @@ _row() {
     local raw="$2"
     [ ${#raw} -gt $((MSG_W-1)) ] && raw="${raw:0:$((MSG_W-3))}..."
     msg=$(printf "%-${MSG_W}s" "$raw")
-    printf "${DGRAY}  │${RESET}  ${CYAN}%s${RESET}  ${DGRAY}│${RESET}  %s  ${DGRAY}│${RESET}\n" "$hash" "$msg"
-}
-
-_footer() {
-    echo -e "${DGRAY}  ╰$(_rep $((HASH_W+2)) '─')┴$(_rep $((MSG_W+2)) '─')╯${RESET}"
+    printf "  ${BLUE}%s${RESET}   ${WHITE}%s${RESET}\n" "$hash" "$msg"
 }
 
-# ── Progress bar animation ────────────────────────────────────────────
 _progress() {
     local label="$1"
-    local total=28
-    printf "  ${GRAY}[${RESET}"
-    for ((i=1; i<=total; i++)); do
-        printf "${CYAN}█${RESET}"
-        sleep 0.018
+    printf "  ${GRAY}%-28s ${RESET}" "$label"
+    for ((i=1; i<=20; i++)); do
+        printf "${WHITE}·${RESET}"
+        sleep 0.015
     done
-    printf "${GRAY}]${RESET}  ${GREEN}${label}${RESET}\n"
+    printf " ${GREEN}✔${RESET}\n"
 }
 
 # ── Core utilities ────────────────────────────────────────────────────
@@ -61,7 +63,7 @@ abort() {
 }
 
 ask() {
-    echo -ne "\n  ${YELLOW}${BOLD}?${RESET}  $1 ${GRAY}[y/N]${RESET}  "
+    echo -ne "\n  ${WHITE}${BOLD}?${RESET}  $1 ${GRAY}(y/N)${RESET}  "
     read -r _r
     [[ "$_r" =~ ^([yY][eE][sS]|[yY])$ ]]
 }
@@ -86,23 +88,20 @@ LOCAL_ONLY_TAGS=$(
 TAG_COUNT=0
 [ -n "$LOCAL_ONLY_TAGS" ] && TAG_COUNT=$(echo "$LOCAL_ONLY_TAGS" | grep -c .)
 PUSH_TAGS=""
-[ "$TAG_COUNT" -gt 0 ] && PUSH_TAGS="--tags"
+[ "$TAG_COUNT" -gt 0 ] && PUSH_TAGS="--follow-tags"
 
 case "$CURRENT_BRANCH" in
     main|master) BLABEL="${RED}${BOLD}⬡  PRODUCTION${RESET}" ;;
-    dev|develop) BLABEL="${YELLOW}◈  INTEGRATION${RESET}" ;;
-    feat/*)      BLABEL="${GREEN}◈  FEATURE${RESET}" ;;
-    fix/*)       BLABEL="${CYAN}◈  BUGFIX${RESET}" ;;
-    refactor/*)  BLABEL="${BLUE}◈  REFACTOR${RESET}" ;;
     *)           BLABEL="${GRAY}◈  BRANCH${RESET}" ;;
 esac
 
 # ── Phase 1 · Working tree check ─────────────────────────────────────
 clear
+_logo
+_sep
 echo ""
-echo -e "  ${WHITE}${BOLD}◆  GITHUB SYNC${RESET}  ${DGRAY}·  Integrity Gate  ·  @wistantkode/dotfiles${RESET}"
+echo -e "  ${WHITE}${BOLD}◆  INTEGRITY GATE${RESET}  ${DGRAY}·  Software Engineer${RESET}"
 echo ""
-_sep
 
 if ! git diff-index --quiet HEAD -- 2>/dev/null; then
     echo ""
@@ -113,10 +112,9 @@ if ! git diff-index --quiet HEAD -- 2>/dev/null; then
 fi
 
 # ── Phase 2 · Summary panel ───────────────────────────────────────────
-echo ""
-printf "  ${GRAY}%-14s${RESET}  ${CYAN}${BOLD}%s${RESET}  %b\n"    "Branch"   "$CURRENT_BRANCH" "$BLABEL"
-printf "  ${GRAY}%-14s${RESET}  ${BOLD}%s${RESET} commit(s) ahead of remote\n" "Ahead"  "$COMMIT_COUNT"
-printf "  ${GRAY}%-14s${RESET}  ${BOLD}%s${RESET} to publish\n"                "Tags"   "$TAG_COUNT"
+printf "  ${GRAY}%-12s${RESET}  ${WHITE}${BOLD}%s${RESET}  %b\n"    "Branch"   "$CURRENT_BRANCH" "$BLABEL"
+printf "  ${GRAY}%-12s${RESET}  ${WHITE}%s${RESET} commit(s) ahead\n" "Ahead"  "$COMMIT_COUNT"
+printf "  ${GRAY}%-12s${RESET}  ${WHITE}%s${RESET} to publish\n"      "Tags"   "$TAG_COUNT"
 echo ""
 _sep
 
@@ -129,7 +127,7 @@ if [ "$COMMIT_COUNT" -gt 0 ]; then
         m=$(echo "$line" | cut -d' ' -f2-)
         _row "$h" "$m"
     done <<< "$COMMITS_RAW"
-    _footer
+    _sep
 fi
 
 # Tags list
@@ -137,70 +135,40 @@ if [ "$TAG_COUNT" -gt 0 ]; then
     echo ""
     echo -e "  ${GRAY}Unpublished tags:${RESET}"
     while IFS= read -r tag; do
-        echo -e "    ${GREEN}+${RESET}  ${BOLD}$tag${RESET}"
+        echo -e "    ${GREEN}✔${RESET}  ${WHITE}${BOLD}$tag${RESET}"
     done <<< "$LOCAL_ONLY_TAGS"
+    _sep
 fi
 
+# ── Phase 3 · Final confirmation ──────────────────────────────────────
 echo ""
-_sep
-
-# ── Phase 3 · Branch gate ─────────────────────────────────────────────
-echo ""
-case "$CURRENT_BRANCH" in
-    main|master)
-        echo -e "  ${RED}${BOLD}⚠  PRODUCTION BRANCH${RESET}"
-        echo -e "  ${DIM}Every push to this branch triggers the public release pipeline.${RESET}"
-        ask "You are on ${BOLD}${CURRENT_BRANCH}${RESET}. Proceed to final review?" \
-            || abort "Cancelled by operator."
-        ;;
-    dev|develop)
-        echo -e "  ${YELLOW}${BOLD}◈  INTEGRATION BRANCH${RESET}"
-        ask "Push to ${BOLD}${REMOTE}${RESET}?" || abort "Cancelled by operator."
-        ;;
-    *)
-        ask "Push ${BOLD}${CURRENT_BRANCH}${RESET} to remote?" || abort "Cancelled by operator."
-        ;;
-esac
-
-# ── Phase 4 · Final confirmation ──────────────────────────────────────
-echo ""
-_sep
+SUMMARY="${WHITE}${BOLD}${COMMIT_COUNT}${RESET} commit(s)"
+[ "$TAG_COUNT" -gt 0 ] && SUMMARY+=" ${DGRAY}+${RESET} ${WHITE}${BOLD}${TAG_COUNT}${RESET} tag(s)"
+printf "  ${GRAY}%-12s${RESET}  %b\n" "Will push"  "$SUMMARY"
+printf "  ${GRAY}%-12s${RESET}  ${BLUE}%s${RESET}\n" "Target" "$REMOTE"
 echo ""
-SUMMARY="${BOLD}${COMMIT_COUNT}${RESET} commit(s)"
-[ "$TAG_COUNT" -gt 0 ] && SUMMARY+="  ${DGRAY}+${RESET}  ${BOLD}${TAG_COUNT}${RESET} tag(s)"
-printf "  ${GRAY}%-14s${RESET}  %b\n" "Will push"  "$SUMMARY"
-printf "  ${GRAY}%-14s${RESET}  ${BOLD}%s${RESET}\n" "Target" "$REMOTE"
-echo ""
-echo -e "  ${DIM}SSH key passphrase will be required by git if not cached.${RESET}"
 
-ask "${BOLD}Confirm push?${RESET}  ${GRAY}This cannot be undone.${RESET}" \
-    || abort "Final gate: push cancelled."
+ask "Confirm push to remote?" || abort "Gate: push cancelled."
 
-# ── Phase 5 · Remote projection ───────────────────────────────────────
+# ── Phase 4 · Projection ──────────────────────────────────────────────
 echo ""
 _sep
 echo ""
-_progress "Initializing..."
-_progress "Verifying integrity state..."
-_progress "Ready — handing off to git."
-echo ""
-echo -e "  ${DGRAY}$(_rep 64 '─')${RESET}"
-echo -e "  ${BOLD}▶  git push${RESET}  ${DGRAY}(passphrase prompt appears below if required)${RESET}"
-echo -e "  ${DGRAY}$(_rep 64 '─')${RESET}"
+_progress "Initializing sync"
+_progress "Verifying state"
+_progress "Final handoff"
 echo ""
 
 if git push --quiet $PUSH_TAGS; then
     echo ""
     _sep
     echo ""
-    echo -e "  ${GREEN}${BOLD}✔  SUCCESS${RESET}  Infrastructure synchronized with ${BOLD}${REMOTE}${RESET}."
-    [ "$TAG_COUNT" -gt 0 ] && \
-        echo -e "  ${GRAY}Tags published. GitHub Actions pipeline may now be triggered.${RESET}"
+    echo -e "  ${GREEN}${BOLD}✔  SUCCESS${RESET}  Infrastructure synchronized."
     echo ""
     _sep
 else
     echo ""
-    abort "Git push failed. Check your SSH key or network connectivity."
+    abort "Git push failed. Check connectivity."
 fi
 
 echo ""

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@wistantkode/dotfiles",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "High-End Linux Infrastructure & AI-Driven Orchestration Protocols",
   "main": "index.js",
   "type": "module",
   "bin": {
-    "dotfiles": "bin/cli.mjs"
+    "dotfiles": "cli/cli.mjs"
   },
   "repository": {
     "type": "git",

package/bin/cli.mjs

@@ -1,103 +0,0 @@
-#!/usr/bin/env node
-
-import { copyFile, mkdir, readdir, lstat } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-// ── UI Configuration (256-color) ──────────────────────────────────────
-const RESET  = '\x1b[0m';
-const BOLD   = '\x1b[1m';
-const DIM    = '\x1b[2m';
-const CYAN   = '\x1b[38;5;117m';
-const GREEN  = '\x1b[38;5;114m';
-const YELLOW = '\x1b[38;5;221m';
-const RED    = '\x1b[38;5;203m';
-const GRAY   = '\x1b[38;5;244m';
-const WHITE  = '\x1b[38;5;255m';
-const DGRAY  = '\x1b[38;5;238m';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const pkgRoot = join(__dirname, '..');
-
-const FILES_TO_INSTALL = [
-  'gitignore',
-  'LICENSE'
-];
-
-const DIRECTORIES_TO_INSTALL = [
-  'protocols'
-];
-
-// ── Utilities ─────────────────────────────────────────────────────────
-
-const sep = () => console.log(`${DGRAY}${'─'.repeat(60)}${RESET}`);
-
-const progress = async (label) => {
-  process.stdout.write(`  ${GRAY}[${RESET}`);
-  for (let i = 0; i < 24; i++) {
-    process.stdout.write(`${CYAN}█${RESET}`);
-    await new Promise(r => setTimeout(r, 15));
-  }
-  process.stdout.write(`${GRAY}]${RESET}  ${GREEN}${label}${RESET}\n`);
-};
-
-async function copyRecursive(src, dest) {
-  const stat = await lstat(src);
-  if (stat.isDirectory()) {
-    await mkdir(dest, { recursive: true });
-    const children = await readdir(src);
-    for (const child of children) {
-      await copyRecursive(join(src, child), join(dest, child));
-    }
-  } else {
-    await copyFile(src, dest);
-  }
-}
-
-async function run() {
-  console.clear();
-  console.log(`\n  ${WHITE}${BOLD}◆  DOTFILES INSTALLER${RESET}  ${DGRAY}·  @wistantkode/dotfiles${RESET}\n`);
-  sep();
-
-  const targetDir = process.cwd();
-  console.log(`\n  ${GRAY}Target Directory:${RESET}  ${CYAN}${BOLD}${targetDir}${RESET}\n`);
-  
-  sep();
-  console.log(`\n  ${BOLD}▶  Initiating deployment...${RESET}\n`);
-
-  await progress('Verifying package integrity...');
-  
-  // Files deployment
-  for (const file of FILES_TO_INSTALL) {
-    try {
-      const destName = file === 'gitignore' ? '.gitignore' : file;
-      await copyFile(join(pkgRoot, file), join(targetDir, destName));
-      console.log(`      ${GREEN}✔${RESET}  Deployed ${BOLD}${destName}${RESET}`);
-    } catch (err) {
-      console.error(`      ${RED}✘${RESET}  Failed to deploy ${file}: ${err.message}`);
-    }
-  }
-
-  // Directories deployment
-  for (const dir of DIRECTORIES_TO_INSTALL) {
-    try {
-      const destName = dir === 'protocols' ? '.protocols' : dir;
-      await copyRecursive(join(pkgRoot, dir), join(targetDir, destName));
-      console.log(`      ${GREEN}✔${RESET}  Deployed ${BOLD}${destName}/${RESET}`);
-    } catch (err) {
-      console.error(`      ${RED}✘${RESET}  Failed to deploy ${dir}: ${err.message}`);
-    }
-  }
-
-  await progress('Finalizing configuration...');
-
-  console.log(`\n  ${GREEN}${BOLD}✔  SUCCESS${RESET}  Infrastructure deployed successfully.`);
-  console.log(`  ${GRAY}Your environment is now orchestrated by @wistantkode protocols.${RESET}\n`);
-  sep();
-  console.log('');
-}
-
-run().catch(err => {
-  console.error(`\n  ${RED}${BOLD}✗  FATAL ERROR${RESET}  ${err.message}\n`);
-  process.exit(1);
-});