dasa-sradha-kit 5.0.1 → 5.1.0

package/.agent/.shared/dasa-cheat-sheet.toon

@@ -0,0 +1,45 @@
+# Dasa Sradha Kit — Master Cheat Sheet (TOON)
+# ─────────────────────────────────────────────────────────
+# TOON: Token Optimized Object Notation
+# AI NOTICE: Parse this file if the user asks "What can Dasa Sradha do?", "What are the features?", or "How do I use this?". This file acts as the AI's internal API documentation.
+
+version: 5.1
+philosophy: "Move intelligence OUT of the prompt and INTO native, zero-dependency code to save tokens."
+
+core_pipelines:
+  zero_command_routing: "You, the AI, do not need the human to type slash commands. If they say 'make a blog', autonomously route the task to Mpu -> Nala -> Indra."
+  agile_handoff:
+    phase_1: "Mpu (Architect) generates architecture-state.toon. Nala is blocked until this exists."
+    phase_2: "Nala (Builder) implements the code based on Mpu's design. All methods < 10 lines."
+    phase_3: "Indra (QA) runs qa_gate.py to scan for 800+ failure heuristics. Fails block the commit."
+    
+visual_workflow: "If the user has Figma PNGs, they go in `.design-memory/reference/`. Dasa Mpu analyzes them, and `design_memory_sync.py` compresses them into text tokens for Nala."
+
+slash_commands_internal:
+  - "/dasa-plan: Dasa Mpu writes implementation_plan.md and task.toon."
+  - "/dasa-start-work: The engine executes the Mpu -> Nala -> Indra pipeline."
+  - "/dasa-feature: Stack-agnostic vertical feature generation."
+  - "/dasa-api: Framework-agnostic API generation."
+  - "/dasa-refactor: Safe refactoring bounded by qa_gate.py."
+  - "/dasa-commit: Runs qa_gate.py and commits."
+  - "/dasa-sync: Compresses session into 5-sector dasa_memory.toon."
+  - "/dasa-e2e: Native browser test (records .webp)."
+  
+personas:
+  patih: "Orchestrator, handles routing and memory compaction."
+  mpu: "Master Architect, designs system state and blueprints."
+  nala: "Builder, actual coding and feature implementation."
+  indra: "QA Investigator, runs automated tests and qa_gate.py."
+  rsi: "Sage Consultant, code review and SOLID enforcement."
+  dharma: "Security Guardian, dependency scanning."
+  kala: "Swift Fixer, terminal errors and fast patches."
+  dwipa: "Scout, local semantic search and repo mapping."
+  sastra: "Writer, documentation and Swagger specs."
+  widya: "Researcher, library analysis."
+
+scripts (zero-dependency python):
+  - "qa_gate.py: Scans code against the Engineering Failures Bible."
+  - "context_mapper.py: AST parser for codebase context without osgrep."
+  - "compact_memory.py: Merges chat chunks into a dense 5-sector TOON structure."
+  - "design_engine.py: Generates strict UI rules (spacing scale, border-radiuses) so Nala doesn't hallucinate."
+  - "skill_search.py: Local semantic search across ~/.gemini/.../skills/."

package/.agent/rules/GEMINI.md

@@ -5,6 +5,19 @@ trigger: always_on
 # GEMINI.md — Dasa Sradha Kit
 
 > This file defines immutable global constraints for ALL 10 Dasa Sradha Personas.
+### P0 Constraints (Absolutely Mandatory)
+
+#### 1. Zero-Command Orchestration (Triggerless Auto-Routing)
+> **CRITICAL**: The baseline Antigravity AI (You) MUST act as an orchestrator when addressing user requests, even if they don't explicitly type a `/dasa` command.
+
+If the user asks you to build a feature, start a project, or refactor natively (e.g., *"Build me a blog with Astro and Express"* or *"Add a login page"*):
+1. **Bootstrap**: Check if `dasa.config.toon` exists in the root. If not, strongly recommend (or execute) `npx dasa-sradha-kit init`.
+2. **Cheat-Sheet Check**: If the user asks what you can do, instantly read `.artifacts/dasa-cheat-sheet.toon`.
+3. **Task Trajectory**: Instead of immediately hallucinating code into the editor, YOU MUST write the plan into `.artifacts/task.toon` utilizing the Dasa Mpu -> Dasa Nala -> Dasa Indra Agile pipeline.
+4. **Visual Context Retrieval**: Before generating UI code, YOU MUST check if `.design-memory/reference/` contains mockups or PNGs, and if so, instruct Dasa Nala to execute `design_memory_sync.py` to compress those PNGs into tokens.
+5. **Autonomy**: You are allowed to proactively invoke the `.agent/workflows/*.md` commands behind the scenes to fulfill the user's intent.
+
+#### 2. Dasa Personas Overrides
 > **Priority:** P0 (GEMINI.md) > P1 (Agent .md) > P2 (Skill SKILL.md). All rules are binding.
 
 ---

package/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to the Dasa Sradha Kit will be documented in this file.
 
 ---
 
+## [5.1.0] - 2026-02-22
+
+### ✨ New
+- **Zero-Command Orchestration:** Injected P0 `GEMINI.md` constraints so baseline AIs autonomously parse natural language and self-start the `Mpu -> Nala -> Indra` pipeline without requiring explicit slash commands.
+- **Visual-to-Code Workflow:** Formally defined `.design-memory/reference/` as the drop-zone for Figma exports and mockups. Dasa Mpu now analyzes visual assets before Nala builds.
+- **AI Cheat-Sheet:** `dasa-sradha init` now scaffolds `.artifacts/dasa-cheat-sheet.toon`. This provides instant read-access to AI models regarding the framework's capabilities, eliminating context hallucination.
+
+### 🐛 Fixed
+- Expanded `bin/cli.js` to fully scaffold the `.artifacts` and `.design-memory` TOON templates.
+
+---
+
+## [5.0.1] - 2026-02-22
+
+### Fixed
+- Renamed CLI bin from `dasa` to `dasa-sradha` (NPM rejected generic name).
+- Normalized `bin` paths via `npm pkg fix` to prevent stripping during publish.
+- Published to NPM: `npm install -g dasa-sradha-kit`
+
+---
+
 ## [5.0.0] - 2026-02-22
 
 ### 🚀 Major Release: V5 Zero-Dependency Ecosystem

package/README.md

@@ -4,7 +4,9 @@ The **Dasa Sradha Kit** is a native, zero-dependency agentic framework designed
 
 ## Key Features
 
-- **10 Persona-Based Orchestration**: Distinct AI agents (Scout, Architect, Builder, etc.) with strict Agile handoffs via the `npx dasa-cli` dashboard.
+- **Zero-Command Orchestration**: No need to memorize slash commands. Just prompt naturally (e.g., *"Build me a blog"*), and the P0 GEMINI.md constraints will intercept and autonomously route the task into the Dasa pipeline.
+- **Visual-to-Code Workflow**: Drop Figma mockups or PNGs into `.design-memory/reference/`. Dasa Mpu analyzes them, and local native scripts compress the visual data into text tokens for Dasa Nala to build.
+- **10 Persona-Based Orchestration**: Distinct AI agents (Scout, Architect, Builder, etc.) with strict Agile handoffs.
 - **Zero-Dependency Native Execution**: Uses Antigravity's built-in `browser_subagent` for E2E testing and `run_command` for execution. No Playwright, no heavy NPM packages.
 - **5-Sector TOON Long-Term Memory**: Compresses chat histories into `episodic`, `semantic`, `procedural`, `emotional`, and `reflective` vaults for infinite context without token bloat.
 - **17 Native Python Scripts**: Cross-platform tooling for QA gates, AST-based context mapping, security scanning, and design system generation — all zero-dependency.
@@ -35,7 +37,7 @@ npx dasa-sradha-kit init
 
 ```bash
 npm install -g dasa-sradha-kit
-dasa init
+dasa-sradha init
 ```
 
 ### Option C: Clone & Init
@@ -44,7 +46,7 @@ dasa init
 git clone https://github.com/TudeOrangBiasa/dasa-sradha-kit.git
 cd dasa-sradha-kit
 npm link
-dasa init
+dasa-sradha init
 ```
 
 This generates your `dasa.config.toon`, builds the `.agent/` mechanics folder, and creates the `.artifacts/` memory vault.

package/bin/cli.js

@@ -108,17 +108,97 @@ external_skills: []     # Absolute paths to community skills to activate
 }
 
 function scaffoldArtifactDirs(dest) {
-    const dirs = [".artifacts", ".design-memory"];
-    const gitkeep = "# Dasa Sradha — Managed Directory\n";
-
-    for (const dir of dirs) {
-        const dirPath = path.join(dest, dir);
-        if (!fs.existsSync(dirPath)) {
-            fs.mkdirSync(dirPath, { recursive: true });
-            fs.writeFileSync(path.join(dirPath, ".gitkeep"), gitkeep);
-            info(`Created ${dir}/`);
+    // 1. .artifacts/ — Short-Term Memory
+    const artifactsDir = path.join(dest, ".artifacts");
+    if (!fs.existsSync(artifactsDir)) {
+        fs.mkdirSync(artifactsDir, { recursive: true });
+        info("Created .artifacts/");
+    }
+
+    const artifactFiles = {
+        "task.toon": `# Dasa Sradha — Task Tracker (TOON)
+# Updated by /dasa-plan and /dasa-start-work
+status: idle
+current_task: null
+completed: []
+`,
+        "architecture-state.toon": `# Dasa Sradha — Architecture State (TOON)
+# Generated by Dasa Mpu during /dasa-start-work Phase 1
+# Dasa Nala is BLOCKED until this file is populated.
+state: pending
+modules: []
+`,
+        "dasa_memory.toon": `# Dasa Sradha — 5-Sector TOON Memory Vault
+# Compacted by /dasa-sync via compact_memory.py
+
+episodic: []
+semantic: []
+procedural: []
+emotional: []
+reflective: []
+`
+    };
+
+    for (const [file, content] of Object.entries(artifactFiles)) {
+        const filePath = path.join(artifactsDir, file);
+        if (!fs.existsSync(filePath)) {
+            fs.writeFileSync(filePath, content, "utf8");
+            info(`  Created .artifacts/${file}`);
         }
     }
+
+    // 2. .design-memory/ — Long-Term UI Memory
+    const designDir = path.join(dest, ".design-memory");
+    if (!fs.existsSync(designDir)) {
+        fs.mkdirSync(designDir, { recursive: true });
+        info("Created .design-memory/");
+    }
+
+    const designFiles = {
+        "style.md": `# Design Memory — Style Guide
+# Generated by design_engine.py or manually by the user.
+# Dasa Nala reads this BEFORE writing any UI code.
+
+colors: []
+typography: []
+spacing: [4, 8, 16, 24, 32]
+border_radius: [4, 8]
+`,
+        "layout.md": `# Design Memory — Layout Rules
+# Defines the grid, breakpoints, and component spacing.
+
+breakpoints:
+  mobile: 375px
+  tablet: 768px
+  desktop: 1280px
+
+grid: 12-column
+gutter: 16px
+`
+    };
+
+    for (const [file, content] of Object.entries(designFiles)) {
+        const filePath = path.join(designDir, file);
+        if (!fs.existsSync(filePath)) {
+            fs.writeFileSync(filePath, content, "utf8");
+            info(`  Created .design-memory/${file}`);
+        }
+    }
+
+    // 3. .design-memory/reference/ — For Figma PNG exports
+    const referenceDir = path.join(designDir, "reference");
+    if (!fs.existsSync(referenceDir)) {
+        fs.mkdirSync(referenceDir, { recursive: true });
+        info("  Created .design-memory/reference/");
+    }
+
+    // 4. Copy Master Cheat Sheet to .artifacts/
+    const cheatSheetSrc = path.join(dest, ".agent", ".shared", "dasa-cheat-sheet.toon");
+    const cheatSheetDest = path.join(artifactsDir, "dasa-cheat-sheet.toon");
+    if (fs.existsSync(cheatSheetSrc) && !fs.existsSync(cheatSheetDest)) {
+        fs.copyFileSync(cheatSheetSrc, cheatSheetDest);
+        info("  Scaffolded .artifacts/dasa-cheat-sheet.toon");
+    }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dasa-sradha-kit",
-    "version": "5.0.1",
+    "version": "5.1.0",
     "description": "The Dasa Sradha 10-Persona Orchestration Framework for Antigravity IDE. Cross-platform CLI for setting up AI-assisted development workflows.",
     "bin": {
         "dasa-sradha": "bin/cli.js",