haraps 1.0.2 → 1.0.4
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/README.md +46 -0
- package/bin/index.js +1 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Haraps (Hara XY Project Scaffolder)
|
|
2
|
+
|
|
3
|
+
Haraps is a high-performance, automated project scaffolding CLI tailored for the **Hara XY ecosystem**. It rapidly provisions a new repository with everything an AI Coding Agent needs to execute at a senior engineering level.
|
|
4
|
+
|
|
5
|
+
With a single command, Haraps injects standardized development scripts, deployment workflows, and aggressive AI alignment rules into your repository.
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
In any new or empty repository, simply run:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx --yes haraps
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
No installation or configuration is required. The CLI will dynamically generate the environment in the current working directory.
|
|
16
|
+
|
|
17
|
+
## What it Generates
|
|
18
|
+
|
|
19
|
+
When you run Haraps, it creates the following structure:
|
|
20
|
+
|
|
21
|
+
### 1. Dev & Deploy Scripts
|
|
22
|
+
- **`dev.sh` / `dev.ps1`**: Highly optimized local development runners that concurrently launch your Next.js frontend (port 3000) and Rust Cloudflare Worker backend (port 8787). Includes aggressive auto-cleanup for orphaned ports and a custom terminal dashboard.
|
|
23
|
+
- **`deploy.sh` / `deploy.ps1`**: Standardized production deployment scripts mapping the backend to Cloudflare Wrangler and the frontend to Vercel.
|
|
24
|
+
|
|
25
|
+
### 2. High-Performance Engineering Standards
|
|
26
|
+
- **`AGENTS.md`**: Injects 20 hardcore engineering rules instructing the AI to prioritize edge-first execution, strict typing, zero-warning linting, security-first principles, and accessibility.
|
|
27
|
+
|
|
28
|
+
### 3. Start Project Protocol
|
|
29
|
+
When you open your Coding Agent in a newly scaffolded directory and type **"start project"**, the agent is hardcoded to:
|
|
30
|
+
1. Ask you for the project name and description.
|
|
31
|
+
2. Initialize the Next.js frontend and Rust backend adhering to your high-performance standards.
|
|
32
|
+
3. Automatically initialize a new Git repository and make the first commit.
|
|
33
|
+
|
|
34
|
+
### 4. Specialized Agent Skills & Workflows
|
|
35
|
+
- **Ponytail (Lazy Senior Dev Mode)**: Enforces "the best code is the code never written", mandating deletion over addition and standard library usage over new dependencies.
|
|
36
|
+
- **Security Review**: Equips the agent to reason like a security researcher, scanning for deep data flow vulnerabilities before deploying.
|
|
37
|
+
- **Kill AI Slop**: Strips out cliché AI-generated aesthetics (e.g., indigo gradients, excessive emojis) in favor of clean, accessible UI.
|
|
38
|
+
- **UI Sniper Telegram**: Sets up a webhook-based UI feedback loop straight to a Telegram group.
|
|
39
|
+
- **Workflows**: Includes `git-it` (safe atomic rebasing and pushing) and `deploy-and-talk` (deployment with Telegram notifications).
|
|
40
|
+
|
|
41
|
+
## Publishing Updates
|
|
42
|
+
|
|
43
|
+
To publish an update to the Haraps CLI:
|
|
44
|
+
1. Update the scaffolding logic in `bin/index.js`.
|
|
45
|
+
2. Bump the version in `package.json`.
|
|
46
|
+
3. Run `npm publish` in the package directory.
|
package/bin/index.js
CHANGED
|
@@ -254,6 +254,7 @@ When the user says "start project", you MUST immediately:
|
|
|
254
254
|
1. Ask the user for the name of the project and a brief description of what they want to build.
|
|
255
255
|
2. Wait for their response.
|
|
256
256
|
3. Once they respond, use their details to initialize the Next.js frontend (in \`frontend/\`) and Rust backend (in \`backend/\`), adhering to all High-Performance Engineering Standards.
|
|
257
|
+
4. Initialize a new git repository in the root directory (\`git init\`) and create an initial commit.
|
|
257
258
|
`);
|
|
258
259
|
|
|
259
260
|
// 4. Workflows
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "haraps",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.4",
|
|
4
4
|
"description": "NPM package to scaffold standard development environment, deployment scripts, AGENTS.md guidelines, and core workflows for a Next.js frontend + Rust Cloudflare Worker backend.",
|
|
5
5
|
"main": "bin/index.js",
|
|
6
6
|
"bin": {
|