capsalock 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Vinayak Singh (WhisperingPetX)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,141 @@
-# Temporary Holding Version
+# 🛡️ Capsalock — Sovereign Security Auditor, Auto-Fixer & Dev Platform
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Enterprise-grade, zero-dependency sovereign static application security testing (SAST), software composition analysis (SCA), secrets detection, and deterministic auto-remediation engine.
+
+[![npm version](https://img.shields.io/badge/npm-v1.0.0-blue.svg)](https://www.npmjs.com/package/capsalock)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://capsalock.vercel.app)
+
+---
+
+## ⚡ Quick Start: Instant CLI Usage
+
+Run zero-footprint security audits anywhere in the world without sending code to any cloud:
+
+```bash
+# 1. Instant audit without installing anything (via npx)
+npx capsalock scan .
+
+# 2. Audit a specific folder or service
+npx capsalock scan src/services/
+
+# 3. Interactive or automated safe in-place auto-fix
+npx capsalock fix
+npx capsalock fix --yes
+
+# 4. CI/CD Pipeline Quality Gate (exits with code 1 on violations)
+npx capsalock scan . --fail-on=critical --format=json
+```
+
+### Global Installation (Optional)
+
+```bash
+# Install globally via npm
+npm install -g capsalock
+
+# Run from any folder on Windows, macOS, or Linux
+capsalock --version
+capsalock scan
+capsalock fix
+```
+
+---
+
+## 🚀 Web Application Platform
+
+
+## ✨ Key Features
+
+1. **🐙 GitHub Authentication & Multi-Repo Switcher**:
+   - Direct GitHub Personal Access Token (PAT) authentication for live GitHub API synchronization.
+   - 1-Click Demo accounts pre-loaded with rich, realistic enterprise repositories and tasks.
+   - Switch between repositories instantly with stars, forks, and branch tracking.
+
+2. **📋 Interactive Kanban Board & Table Views**:
+   - 5 workflow columns: **Backlog**, **To Do**, **In Progress**, **In Review**, and **Done**.
+   - Native drag-and-drop or 1-click quick-move between columns with optimistic UI updates.
+   - Subtasks checklist with live completion meters and celebratory confetti on completion.
+   - Comprehensive tabular list with multi-column sorting, bulk actions, and search filtering.
+
+3. **⏰ Deadline Management & Smart Notifications**:
+   - Target date & time scheduling for every deliverable.
+   - Real-time countdown badges: **Overdue** (pulsing red alert), **Due Today** (amber), and **On Track** (green).
+   - In-app Notification Drawer with category filters (Deadlines, Assignments, Sync Events) and pleasant synthesized Web Audio alert chimes.
+
+4. **📊 Analytics Dashboard & Visual Intelligence**:
+   - Interactive SVG Sprint Burndown & Velocity slope chart.
+   - Workload Priority Matrix (Critical P0, High P1, Medium P2, Low P3) circular donut chart.
+   - Workflow Status Pipeline distribution funnel.
+   - Contributor Productivity Leaderboard with resolution speed and on-time completion rates.
+
+5. **👥 Role-Based Access Control (RBAC) & Team Management**:
+   - 4 distinct access tiers:
+     - **Admin**: Full control, project deletion, user roles and security tokens.
+     - **Manager**: Sprint planning, task assignments, and executive reporting.
+     - **Developer**: Task creation, status updates, and checklist execution.
+     - **Viewer**: Read-only stakeholder access to dashboards and exports.
+   - Member roster with individual active vs completed workload bars.
+
+6. **🎯 Milestones & Sprints Roadmap**:
+   - Group deliverables into version releases (e.g. `v2.4 - Offline Sync Release`).
+   - Dynamic progress bars tracking percentage of linked tasks resolved.
+
+7. **📡 Offline Access & Cloud Synchronization**:
+   - Offline-first architecture persisting state in `localStorage` and `IndexedDB`.
+   - Mutation queue buffering changes made while disconnected and auto-synchronizing on reconnect.
+   - Simulated Offline Mode toggle for field-testing remote operations.
+
+8. **📜 Immutable Audit Trail & Activity Stream**:
+   - Chronological logging of all team actions with actor attribution, timestamp diffs, and action badges.
+
+9. **📄 Executive PDF & CSV Report Generator**:
+   - 1-click styled PDF executive report generator with KPIs and table layouts.
+   - Raw CSV dataset export for spreadsheet analysis.
+
+10. **🌓 Dark & Light Mode + Quick Command Palette**:
+    - High-contrast accessible theme toggle with smooth transitions.
+    - Global `Ctrl+K` / `Cmd+K` command palette and keyboard shortcut navigation (`N` for new issue).
+
+---
+
+## 🛠️ Tech Stack
+
+- **Frontend**: React 18, TypeScript, Vite
+- **Styling**: Tailwind CSS, Glassmorphism, PostCSS
+- **Icons**: Lucide React
+- **Export Engine**: jsPDF, jsPDF-AutoTable
+- **Animations & Sound**: Canvas-Confetti, Web Audio API Oscillator synthesis
+- **Data Layer**: Offline-first LocalStorage & IndexedDB Engine + GitHub REST API v3
+
+---
+
+## 🚀 Getting Started
+
+### 1. Prerequisites
+- Node.js (v18 or higher)
+- npm
+
+### 2. Running Locally
+
+```bash
+cd capsalock
+npm.cmd install
+npm.cmd run dev
+```
+
+Open your browser and navigate to `http://localhost:5173`.
+
+### 3. Production Build
+
+```bash
+npm.cmd run build
+npm.cmd run preview
+```
+
+---
+
+## ⌨️ Keyboard Shortcuts
+
+- `Ctrl + K` or `Cmd + K`: Open Global Command Palette & Search
+- `N`: Create New Issue (when not typing in an input field)
+- `Esc`: Close any active modal or drawer

package/bin/capsalock.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCli } from './cliEntrypoint.js';
+
+runCli(process.argv.slice(2)).then((exitCode) => {
+  if (typeof exitCode === 'number') {
+    process.exit(exitCode);
+  }
+}).catch((err) => {
+  console.error('[ERROR] CapsaLock fatal error:', err);
+  process.exit(1);
+});