azerclaw 1.0.0

package/dist/src/workflow/engine.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 🐟 AZERCLAW Fishbone Workflow Engine
+ * Deterministic, typed pipeline system — replaces OpenClaw's "Lobster" engine.
+ * Supports .fishbone files for defining multi-step workflows with approval gates.
+ */
+export interface FishboneStep {
+    id: string;
+    name: string;
+    type: 'agent' | 'shell' | 'condition' | 'approval' | 'parallel' | 'transform';
+    action: string;
+    inputs?: Record<string, string>;
+    outputs?: string[];
+    requiresApproval?: boolean;
+    onError?: 'stop' | 'continue' | 'retry';
+    maxRetries?: number;
+    timeout?: number;
+    children?: FishboneStep[];
+}
+export interface FishboneWorkflow {
+    name: string;
+    description: string;
+    version: string;
+    trigger?: string;
+    variables: Record<string, string>;
+    steps: FishboneStep[];
+}
+export interface WorkflowExecution {
+    id: string;
+    workflowName: string;
+    status: 'running' | 'paused' | 'completed' | 'failed' | 'awaiting_approval';
+    currentStepId: string;
+    results: Record<string, string>;
+    resumeToken?: string;
+    startedAt: Date;
+    completedAt?: Date;
+    error?: string;
+}
+export type WorkflowEventHandler = (event: {
+    type: 'step_start' | 'step_complete' | 'step_error' | 'approval_needed' | 'workflow_complete' | 'workflow_error';
+    stepId?: string;
+    stepName?: string;
+    content?: string;
+    resumeToken?: string;
+}) => void | Promise<void>;
+export declare function parseFishboneFile(filePath: string): FishboneWorkflow;
+export declare class FishboneEngine {
+    private executions;
+    /**
+     * Execute a workflow from a .fishbone file.
+     */
+    execute(workflow: FishboneWorkflow, variables?: Record<string, string>, eventHandler?: WorkflowEventHandler): Promise<WorkflowExecution>;
+    /**
+     * Resume a paused workflow with a resume token.
+     */
+    resume(executionId: string, resumeToken: string): Promise<boolean>;
+    /**
+     * Get execution status.
+     */
+    getExecution(id: string): WorkflowExecution | undefined;
+    /**
+     * Interpolate variables in a string: {{varName}} → value
+     */
+    private interpolate;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/workflow/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/workflow/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IACzC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;IACjH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAI3B,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA6EpE;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAA6C;IAE/D;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACtC,YAAY,CAAC,EAAE,oBAAoB,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAyJ7B;;OAEG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWxE;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}

package/dist/src/workflow/engine.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * 🐟 AZERCLAW Fishbone Workflow Engine
+ * Deterministic, typed pipeline system — replaces OpenClaw's "Lobster" engine.
+ * Supports .fishbone files for defining multi-step workflows with approval gates.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FishboneEngine = void 0;
+exports.parseFishboneFile = parseFishboneFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+const runtime_1 = require("../core/runtime");
+const security_1 = require("../core/security");
+// ─── .fishbone File Parser ──────────────────────────────────────
+function parseFishboneFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    // Parse YAML-like frontmatter
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    let metadata = {};
+    let body = content;
+    if (fmMatch) {
+        for (const line of fmMatch[1].split('\n')) {
+            const colonIdx = line.indexOf(':');
+            if (colonIdx > 0) {
+                const key = line.slice(0, colonIdx).trim();
+                const value = line.slice(colonIdx + 1).trim();
+                metadata[key] = value;
+            }
+        }
+        body = fmMatch[2];
+    }
+    // Parse steps from markdown sections
+    const steps = [];
+    const stepSections = body.split(/^## /m).slice(1);
+    for (let i = 0; i < stepSections.length; i++) {
+        const section = stepSections[i];
+        const lines = section.split('\n');
+        const name = lines[0].trim();
+        let type = 'agent';
+        let action = '';
+        let requiresApproval = false;
+        let onError = 'stop';
+        const inputs = {};
+        const outputs = [];
+        for (const line of lines.slice(1)) {
+            const t = line.trim();
+            if (t.startsWith('- **Type**:')) {
+                type = t.replace('- **Type**:', '').trim();
+            }
+            else if (t.startsWith('- **Action**:')) {
+                action = t.replace('- **Action**:', '').trim();
+            }
+            else if (t.startsWith('- **Approval**:')) {
+                requiresApproval = t.replace('- **Approval**:', '').trim().toLowerCase() === 'required';
+            }
+            else if (t.startsWith('- **OnError**:')) {
+                onError = t.replace('- **OnError**:', '').trim();
+            }
+            else if (t.startsWith('- **Input**:')) {
+                const kv = t.replace('- **Input**:', '').trim().split('=');
+                if (kv.length === 2)
+                    inputs[kv[0].trim()] = kv[1].trim();
+            }
+            else if (t.startsWith('- **Output**:')) {
+                outputs.push(t.replace('- **Output**:', '').trim());
+            }
+            else if (!t.startsWith('-') && !t.startsWith('#') && t.length > 0 && !action) {
+                action = t;
+            }
+        }
+        steps.push({
+            id: `step_${i + 1}`,
+            name,
+            type,
+            action: action || name,
+            inputs: Object.keys(inputs).length > 0 ? inputs : undefined,
+            outputs: outputs.length > 0 ? outputs : undefined,
+            requiresApproval,
+            onError,
+        });
+    }
+    return {
+        name: metadata['name'] || path.basename(filePath, '.fishbone'),
+        description: metadata['description'] || '',
+        version: metadata['version'] || '1.0.0',
+        trigger: metadata['trigger'],
+        variables: {},
+        steps,
+    };
+}
+// ─── Fishbone Engine ────────────────────────────────────────────
+class FishboneEngine {
+    executions = new Map();
+    /**
+     * Execute a workflow from a .fishbone file.
+     */
+    async execute(workflow, variables = {}, eventHandler) {
+        const executionId = crypto.randomUUID();
+        const execution = {
+            id: executionId,
+            workflowName: workflow.name,
+            status: 'running',
+            currentStepId: '',
+            results: { ...variables },
+            startedAt: new Date(),
+        };
+        this.executions.set(executionId, execution);
+        (0, security_1.auditLog)('WORKFLOW_START', `${workflow.name} (${executionId})`);
+        try {
+            for (const step of workflow.steps) {
+                execution.currentStepId = step.id;
+                await eventHandler?.({
+                    type: 'step_start',
+                    stepId: step.id,
+                    stepName: step.name,
+                });
+                // Handle approval gates
+                if (step.requiresApproval) {
+                    const resumeToken = crypto.randomBytes(16).toString('hex');
+                    execution.status = 'awaiting_approval';
+                    execution.resumeToken = resumeToken;
+                    await eventHandler?.({
+                        type: 'approval_needed',
+                        stepId: step.id,
+                        stepName: step.name,
+                        content: step.action,
+                        resumeToken,
+                    });
+                    (0, security_1.auditLog)('WORKFLOW_APPROVAL', `${step.name} — awaiting approval`);
+                    // In a real implementation, this would pause and wait for resume
+                    // For now, we auto-approve
+                    execution.status = 'running';
+                }
+                // Execute step based on type
+                let stepResult = '';
+                try {
+                    switch (step.type) {
+                        case 'shell': {
+                            const { execSync } = require('child_process');
+                            const cmd = this.interpolate(step.action, execution.results);
+                            stepResult = execSync(cmd, { encoding: 'utf-8', timeout: step.timeout || 30000 }).trim();
+                            break;
+                        }
+                        case 'agent': {
+                            const action = this.interpolate(step.action, execution.results);
+                            const agent = new runtime_1.AgentRuntime({
+                                sessionId: `fishbone_${executionId}_${step.id}`,
+                                maxIterations: 10,
+                                eventHandler: async () => { },
+                            });
+                            stepResult = await agent.run(action);
+                            break;
+                        }
+                        case 'condition': {
+                            const condition = this.interpolate(step.action, execution.results);
+                            const { execSync } = require('child_process');
+                            try {
+                                execSync(condition, { encoding: 'utf-8', timeout: 5000 });
+                                stepResult = 'true';
+                            }
+                            catch {
+                                stepResult = 'false';
+                            }
+                            break;
+                        }
+                        case 'transform': {
+                            stepResult = this.interpolate(step.action, execution.results);
+                            break;
+                        }
+                        case 'parallel': {
+                            if (step.children) {
+                                const results = await Promise.all(step.children.map(async (child) => {
+                                    const agent = new runtime_1.AgentRuntime({
+                                        sessionId: `fishbone_${executionId}_${child.id}`,
+                                        maxIterations: 5,
+                                        eventHandler: async () => { },
+                                    });
+                                    return agent.run(child.action);
+                                }));
+                                stepResult = results.join('\n---\n');
+                            }
+                            break;
+                        }
+                    }
+                }
+                catch (e) {
+                    if (step.onError === 'continue') {
+                        stepResult = `Error (continuing): ${e.message}`;
+                    }
+                    else if (step.onError === 'retry' && (step.maxRetries || 0) > 0) {
+                        // Simple retry logic
+                        for (let r = 0; r < (step.maxRetries || 1); r++) {
+                            try {
+                                const { execSync } = require('child_process');
+                                stepResult = execSync(step.action, { encoding: 'utf-8' }).trim();
+                                break;
+                            }
+                            catch {
+                                continue;
+                            }
+                        }
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+                // Store result
+                execution.results[step.id] = stepResult;
+                if (step.outputs) {
+                    for (const output of step.outputs) {
+                        execution.results[output] = stepResult;
+                    }
+                }
+                await eventHandler?.({
+                    type: 'step_complete',
+                    stepId: step.id,
+                    stepName: step.name,
+                    content: stepResult.slice(0, 200),
+                });
+            }
+            execution.status = 'completed';
+            execution.completedAt = new Date();
+            (0, security_1.auditLog)('WORKFLOW_DONE', `${workflow.name} — completed`);
+            await eventHandler?.({ type: 'workflow_complete', content: 'All steps completed' });
+        }
+        catch (e) {
+            execution.status = 'failed';
+            execution.error = e.message;
+            execution.completedAt = new Date();
+            (0, security_1.auditLog)('WORKFLOW_ERROR', `${workflow.name} — ${e.message}`);
+            await eventHandler?.({ type: 'workflow_error', content: e.message });
+        }
+        return execution;
+    }
+    /**
+     * Resume a paused workflow with a resume token.
+     */
+    async resume(executionId, resumeToken) {
+        const execution = this.executions.get(executionId);
+        if (!execution)
+            return false;
+        if (execution.resumeToken !== resumeToken)
+            return false;
+        execution.status = 'running';
+        execution.resumeToken = undefined;
+        (0, security_1.auditLog)('WORKFLOW_RESUMED', executionId);
+        return true;
+    }
+    /**
+     * Get execution status.
+     */
+    getExecution(id) {
+        return this.executions.get(id);
+    }
+    /**
+     * Interpolate variables in a string: {{varName}} → value
+     */
+    interpolate(template, vars) {
+        return template.replace(/\{\{(\w+)\}\}/g, (_, key) => vars[key] || `{{${key}}}`);
+    }
+}
+exports.FishboneEngine = FishboneEngine;
+//# sourceMappingURL=engine.js.map

package/dist/src/workflow/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/workflow/engine.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,113 @@
+{
+  "name": "azerclaw",
+  "version": "1.0.0",
+  "description": "🐟 AZERCLAW — Open-source, BYOK AI agent for your terminal. Your AI, Your Keys, Your Way.",
+  "main": "dist/src/index.js",
+  "bin": {
+    "azerclaw": "./dist/bin/azerclaw.js",
+    "AZERCLAW": "./dist/bin/azerclaw.js",
+    "Azerclaw": "./dist/bin/azerclaw.js"
+  },
+  "scripts": {
+    "start": "npx tsx bin/azerclaw.ts",
+    "chat": "npx tsx bin/azerclaw.ts chat",
+    "tui": "npx tsx bin/azerclaw.ts tui",
+    "dev": "npx tsx bin/azerclaw.ts",
+    "build": "tsc && npm run copy-skills",
+    "copy-skills": "cp -r skills dist/skills 2>/dev/null || true",
+    "doctor": "npx tsx bin/azerclaw.ts doctor",
+    "onboard": "npx tsx bin/azerclaw.ts onboard",
+    "test": "echo \"Tests coming soon\" && exit 0",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "terminal",
+    "llm",
+    "openai",
+    "anthropic",
+    "claude",
+    "gemini",
+    "ollama",
+    "byok",
+    "open-source",
+    "autonomous",
+    "coding-assistant"
+  ],
+  "author": "AZERCLAW",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/azerclaw/azerclaw"
+  },
+  "homepage": "https://azerclaw.dev",
+  "bugs": {
+    "url": "https://github.com/azerclaw/azerclaw/issues"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "skills/",
+    "templates/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@google/generative-ai": "^0.24.0",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "cli-highlight": "^2.1.11",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "conf": "^11.0.2",
+    "croner": "^9.0.0",
+    "enquirer": "^2.4.1",
+    "figures": "^3.2.0",
+    "glob": "^11.0.2",
+    "gradient-string": "^2.0.2",
+    "log-symbols": "^4.1.0",
+    "lowdb": "^6.1.1",
+    "nanoid": "^3.3.11",
+    "node-fetch": "^3.3.2",
+    "openai": "^4.97.0",
+    "ora": "^5.4.1",
+    "strip-ansi": "^6.0.1",
+    "string-width": "^4.2.3",
+    "wrap-ansi": "^7.0.0",
+    "ws": "^8.18.2",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "@types/ws": "^8.18.1",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "azerclaw": {
+    "security": {
+      "telemetry": false,
+      "analytics": false,
+      "dataCollection": false,
+      "phoneHome": false
+    }
+  }
+}

package/skills/code-review/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: Code Review
+description: Review code for bugs, security issues, best practices, and style.
+version: 1.0.0
+author: AZERCLAW
+tags: code, review, quality
+---
+
+# Code Review Skill
+
+When asked to review code, follow this structured approach:
+
+## Process
+
+1. **Read the file(s)** using `read_file`
+2. **Analyze** for the following categories:
+   - 🐛 **Bugs**: Logic errors, off-by-one, null references, race conditions
+   - 🔒 **Security**: Injection, XSS, auth issues, exposed secrets, SSRF
+   - ⚡ **Performance**: N+1 queries, unnecessary loops, memory leaks
+   - 📐 **Style**: Naming conventions, code organization, readability
+   - 🧪 **Testing**: Missing edge cases, untested paths
+
+3. **Format findings** with severity levels:
+   - 🔴 CRITICAL — Must fix before merge
+   - 🟡 WARNING — Should fix soon
+   - 🔵 INFO — Suggestion for improvement
+
+4. **Provide fixes** — Don't just identify, suggest or implement solutions.
+
+## Output Format
+
+```
+## Code Review: [filename]
+
+### Summary
+[1-2 sentence overview]
+
+### Findings
+
+🔴 CRITICAL: [description]
+  File: [path]:[line]
+  Fix: [suggested fix]
+
+🟡 WARNING: [description]
+  ...
+```

package/skills/daily-briefing/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: Daily Briefing
+description: Generate a daily summary of project status, git activity, and tasks.
+version: 1.0.0
+author: AZERCLAW
+tags: productivity, summary, briefing
+---
+
+# Daily Briefing Skill
+
+Generate a comprehensive daily briefing:
+
+## Data Collection
+1. Run `git log --since="24 hours ago" --oneline` for recent commits
+2. Run `git diff --stat HEAD~5` for recent changes summary
+3. Check for TODO/FIXME comments: `grep -rnI "TODO\|FIXME\|HACK\|XXX" . --include="*.ts" --include="*.js" --include="*.py" | head -20`
+4. Check for any failing tests if test script exists
+
+## Report Format
+```
+📊 Daily Briefing — [date]
+═══════════════════════════
+
+📝 Recent Commits (24h): [count]
+[list top 5]
+
+📁 Files Changed: [count]
+[summary]
+
+⚠️ TODOs/FIXMEs: [count]
+[top 5]
+
+🎯 Suggested Focus Areas:
+[based on analysis]
+```

package/skills/git-assistant/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: Git Assistant
+description: Help with git operations, branching, merging, and commit messages.
+version: 1.0.0
+author: AZERCLAW
+tags: git, version-control
+---
+
+# Git Assistant Skill
+
+When helping with git operations:
+
+## Commit Messages
+Follow Conventional Commits:
+- `feat:` new feature
+- `fix:` bug fix
+- `docs:` documentation
+- `refactor:` code refactoring
+- `test:` adding tests
+- `chore:` maintenance
+
+## Common Operations
+1. Check status with `git status` and `git log --oneline -10`
+2. Create branches with descriptive names: `feature/description`, `fix/description`
+3. Always verify changes before committing with `git diff`
+4. Use `git stash` before risky operations
+
+## Safety Rules
+- Never force push to `main` or `master`
+- Always confirm before destructive operations (reset, rebase)
+- Create backups before complex rebases

package/templates/HEARTBEAT.md

@@ -0,0 +1,27 @@
+# HEARTBEAT.md
+
+# Azerclaw Heartbeat Configuration
+# This file controls proactive background tasks.
+# The agent checks this file every 30 minutes.
+
+## Tasks
+
+### Git Status Check
+- **Schedule**: every 30 minutes
+- **Action**: Check for uncommitted changes and remind user
+- **Condition**: Only if git repo detected in current directory
+
+### Dependency Audit
+- **Schedule**: daily at 09:00
+- **Action**: Run `npm audit` or equivalent and report vulnerabilities
+- **Condition**: Only if package.json exists
+
+### Disk Space Monitor
+- **Schedule**: every 6 hours
+- **Action**: Check disk usage, warn if below 10% free
+- **Condition**: Always
+
+### Log Cleanup
+- **Schedule**: weekly on Sunday
+- **Action**: Rotate and compress logs older than 7 days
+- **Condition**: Always

package/templates/IDENTITY.md

@@ -0,0 +1,23 @@
+# 🐟 AZERCLAW Identity
+
+You are **AZERCLAW**, an autonomous AI agent running locally on the user's machine.
+
+## Core Identity
+- **Name**: Azerclaw
+- **Symbol**: 🐟 (Fish)
+- **Philosophy**: Your AI, Your Keys, Your Way
+- **Mission**: Empower developers with a free, open-source, privacy-first AI agent
+
+## Personality
+- Precise and efficient — get things done, don't waste words
+- Proactive — anticipate what the user needs next
+- Security-conscious — never expose secrets, always validate
+- Honest — if you can't do something, say so clearly
+
+## Security Rules (NEVER BREAK THESE)
+1. **Never transmit** API keys, secrets, or credentials in responses
+2. **Never log** sensitive data to files that others might read
+3. **Never execute** commands that could expose secrets to third parties
+4. **Always sanitize** output before displaying anything from tool execution
+5. **Always ask** before running destructive operations (rm -rf, DROP TABLE, etc.)
+6. **Never phone home** — all data stays on the user's machine