@accelerationguy/accel 1.0.0

package/modules/vector/schemas/vector.schema.json

@@ -0,0 +1,237 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "accelerate/modules/vector/vector.schema.json",
+  "title": "Vector Configuration",
+  "description": "Context Augmentation & Reinforcement Layer — behavioral governance. Nested domain objects: each domain is self-contained with its own rules, decisions, and config. Replaces manifest + domain files + staging.json.",
+  "type": "object",
+  "required": ["version", "config", "domains"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "last_modified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "config": {
+      "type": "object",
+      "description": "Global Vector configuration (previously in manifest header)",
+      "required": ["devmode", "post_compact_gate"],
+      "properties": {
+        "devmode": {
+          "type": "boolean",
+          "description": "When true, Claude appends debug section showing rules/tools/governance",
+          "default": false
+        },
+        "post_compact_gate": {
+          "type": "boolean",
+          "description": "When true, human-in-loop after context compaction. When false, autonomous continuation.",
+          "default": true
+        },
+        "global_exclude": {
+          "type": "array",
+          "description": "Phrases that skip ALL domain matching (casual/off-topic conversations)",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "context_brackets": {
+          "type": "object",
+          "description": "Context window bracket rules — injected based on remaining context percentage",
+          "properties": {
+            "FRESH": { "$ref": "#/$defs/context_bracket" },
+            "MODERATE": { "$ref": "#/$defs/context_bracket" },
+            "DEPLETED": { "$ref": "#/$defs/context_bracket" }
+          },
+          "additionalProperties": { "$ref": "#/$defs/context_bracket" },
+          "default": {}
+        },
+        "commands": {
+          "type": "object",
+          "description": "Star commands (*FOCUS, *LASER, etc.) — keyed by command name, values are rule arrays",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "default": {}
+        }
+      }
+    },
+    "domains": {
+      "type": "object",
+      "description": "Domain definitions keyed by domain name. Each domain is self-contained.",
+      "additionalProperties": { "$ref": "#/$defs/domain" }
+    },
+    "staging": {
+      "type": "array",
+      "description": "Staged rule proposals from PSMM — pending review during Vector hygiene",
+      "items": { "$ref": "#/$defs/staging_entry" },
+      "default": []
+    }
+  },
+  "$defs": {
+    "context_bracket": {
+      "type": "object",
+      "description": "Context bracket configuration for a specific threshold",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Whether this bracket's rules are active",
+          "default": true
+        },
+        "rules": {
+          "type": "array",
+          "description": "Rules to inject when context is in this bracket",
+          "items": { "type": "string" },
+          "default": []
+        }
+      }
+    },
+    "domain": {
+      "type": "object",
+      "required": ["state", "always_on", "rules"],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": ["active", "inactive"],
+          "description": "Whether domain is enabled"
+        },
+        "always_on": {
+          "type": "boolean",
+          "description": "If true, loads regardless of state or recall matching",
+          "default": false
+        },
+        "recall": {
+          "type": "array",
+          "description": "Natural language phrases that trigger on-demand loading",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "exclude": {
+          "type": "array",
+          "description": "Phrases that prevent this domain from loading even if recall matches",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "rules": {
+          "type": "array",
+          "description": "Behavioral rules for this domain",
+          "items": { "$ref": "#/$defs/rule" }
+        },
+        "decisions": {
+          "type": "array",
+          "description": "Logged decisions for this domain",
+          "items": { "$ref": "#/$defs/decision" },
+          "default": []
+        }
+      }
+    },
+    "rule": {
+      "type": "object",
+      "required": ["id", "text"],
+      "properties": {
+        "id": {
+          "type": "integer",
+          "description": "Rule number within domain (0-indexed)"
+        },
+        "text": {
+          "type": "string",
+          "description": "The rule instruction"
+        },
+        "added": {
+          "type": ["string", "null"],
+          "format": "date",
+          "description": "When rule was added"
+        },
+        "last_reviewed": {
+          "type": ["string", "null"],
+          "format": "date",
+          "description": "Last review date"
+        },
+        "source": {
+          "type": ["string", "null"],
+          "description": "Origin of rule (manual, psmm, staging)",
+          "default": "manual"
+        }
+      }
+    },
+    "decision": {
+      "type": "object",
+      "required": ["id", "decision", "rationale", "date"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique decision ID (e.g. global-001, casegate-003)"
+        },
+        "decision": {
+          "type": "string",
+          "description": "What was decided"
+        },
+        "rationale": {
+          "type": "string",
+          "description": "Why this decision was made"
+        },
+        "date": {
+          "type": "string",
+          "format": "date"
+        },
+        "source": {
+          "type": ["string", "null"],
+          "enum": ["manual", "psmm", "session", null],
+          "default": "manual"
+        },
+        "recall": {
+          "type": "array",
+          "description": "Keywords for decision retrieval",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "status": {
+          "type": "string",
+          "enum": ["active", "archived"],
+          "default": "active"
+        }
+      }
+    },
+    "staging_entry": {
+      "type": "object",
+      "required": ["id", "proposed_domain", "rule_text", "created_at"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Staging entry ID"
+        },
+        "source_session": {
+          "type": ["string", "null"],
+          "description": "PSMM session UUID that originated this proposal"
+        },
+        "proposed_domain": {
+          "type": "string",
+          "description": "Target domain for the rule"
+        },
+        "rule_text": {
+          "type": "string",
+          "description": "Proposed rule text"
+        },
+        "rationale": {
+          "type": ["string", "null"],
+          "description": "Why this rule was proposed"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "approved", "rejected"],
+          "default": "pending"
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "reviewed_at": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "default": null
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@accelerationguy/accel",
+  "version": "1.0.0",
+  "description": "Accelerate — Unified Claude Code Agent Framework by Acceleration Guy",
+  "bin": {
+    "accel": "./bin/install.js"
+  },
+  "keywords": [
+    "claude-code",
+    "ai-development",
+    "workflow",
+    "rules-engine",
+    "workspace-management",
+    "skill-builder",
+    "security-audit",
+    "accelerate"
+  ],
+  "author": "Yogi Gnanavel <accelerationguy.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/accelerationguy/accelerate.git"
+  },
+  "homepage": "https://accelerationguy.com/accelerate",
+  "bugs": {
+    "url": "https://github.com/accelerationguy/accelerate/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "modules/",
+    "shared/",
+    "docs/",
+    "README.md",
+    "CLAUDE.md"
+  ]
+}

package/shared/branding/branding.js

@@ -0,0 +1,70 @@
+/**
+ * Accelerate Branding Constants
+ *
+ * Centralised brand identity for the Accelerate monorepo.
+ * All TUI output, installer banners, and user-facing text
+ * should reference these constants for consistency.
+ *
+ * @module shared/branding/branding
+ */
+
+const BRAND = {
+  /** Top-level product name */
+  name: 'Accelerate',
+
+  /** npm scope used by all published packages */
+  scope: '@accel',
+
+  /** CLI binary name */
+  cli: 'accel',
+
+  /** Author */
+  author: 'Yogi Gnanavel',
+
+  /** Author brand */
+  authorBrand: 'Acceleration Guy',
+
+  /** Website */
+  site: 'https://accelerationguy.com',
+
+  /** Product tagline shown in installer banner */
+  tagline: 'Ship faster with structured AI workflows',
+
+  /** TUI colour palette (ANSI 256 / hex for Ink-based renderers) */
+  colors: {
+    primary: '#6C5CE7',
+    secondary: '#00CEC9',
+    accent: '#FDCB6E',
+    success: '#00B894',
+    warning: '#E17055',
+    error: '#D63031',
+    muted: '#636E72',
+    bg: '#2D3436',
+  },
+
+  /**
+   * Human-friendly display names for each module.
+   * Keys match the directory names under modules/.
+   */
+  modules: {
+    vector: { display: 'Vector', tagline: 'Dynamic rules engine' },
+    momentum: { display: 'Momentum', tagline: 'Workspace awareness layer' },
+    drive: { display: 'Drive', tagline: 'Plan-Apply-Unify execution' },
+    ignition: { display: 'Ignition', tagline: 'Project ideation & scaffolding' },
+    radar: { display: 'Radar', tagline: 'Security & quality audits' },
+    forge: { display: 'Forge', tagline: 'Skill authoring toolkit' },
+    'mission-control': { display: 'Mission Control', tagline: 'Orchestration & install' },
+  },
+
+  /** Installer banner (plain-text, coloured at render time) */
+  banner: [
+    '',
+    '  ╔═══════════════════════════════════════╗',
+    '  ║          A C C E L E R A T E          ║',
+    '  ║   Ship faster with structured AI      ║',
+    '  ╚═══════════════════════════════════════╝',
+    '',
+  ].join('\n'),
+};
+
+module.exports = BRAND;

package/shared/config/defaults.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "_comment": "Accelerate default configuration — shared across all modules",
+  "installDir": "~/.accel",
+  "events": {
+    "dir": "~/.accel/events",
+    "archiveDir": "~/.accel/events/archive",
+    "errorsDir": "~/.accel/events/errors",
+    "ttlDays": 7,
+    "archiveCapPerModule": 100,
+    "schemasDir": "~/.accel/events/schemas"
+  },
+  "modules": {
+    "vector": {
+      "configFile": "vector.json",
+      "installDir": "~/.accel/modules/vector",
+      "enabled": true
+    },
+    "momentum": {
+      "surfaces": ["active", "backlog", "projects", "entities", "state"],
+      "installDir": "~/.accel/modules/momentum",
+      "enabled": true
+    },
+    "drive": {
+      "planFile": "PLAN.md",
+      "stateDir": ".paul",
+      "installDir": "~/.accel/modules/drive",
+      "enabled": true
+    },
+    "ignition": {
+      "outputFile": "PLANNING.md",
+      "installDir": "~/.accel/modules/ignition",
+      "enabled": true
+    },
+    "radar": {
+      "phases": {
+        "diagnostic": [0, 1, 2, 3, 4, 5],
+        "transform": [6, 7, 8]
+      },
+      "domains": 14,
+      "installDir": "~/.accel/modules/radar",
+      "enabled": true
+    },
+    "forge": {
+      "skillsDir": "~/.claude/commands",
+      "installDir": "~/.accel/modules/forge",
+      "enabled": true
+    },
+    "mission-control": {
+      "installDir": "~/.accel/modules/mission-control",
+      "enabled": true
+    }
+  },
+  "logging": {
+    "level": "info",
+    "dir": "~/.accel/logs"
+  },
+  "manifestPath": "~/.accel/manifest.json"
+}

package/shared/events/README.md

@@ -0,0 +1,175 @@
+# Accelerate Event Bus
+
+File-based cross-module communication for the Accelerate framework. Modules emit and consume JSON event files through a shared directory (`~/.accel/events/`), enabling loose coupling between modules that may be written in different languages.
+
+## Architecture
+
+```
+~/.accel/events/
+  ├── *.json          # Pending events (consumed on next module invocation)
+  ├── archive/        # Processed events (moved here after consumption)
+  ├── errors/         # Malformed or invalid-producer events
+  └── schemas/        # Event type schemas (optional validation)
+```
+
+Events are simple JSON files. Any language that can read/write JSON files can participate.
+
+## Implementations
+
+| Language   | File                                | Usage                              |
+|------------|-------------------------------------|------------------------------------|
+| Node.js    | `shared/events/event-bus.js`        | Core library for Node.js modules   |
+| Node.js    | `shared/events/integrations.js`     | High-level integration functions   |
+| Python     | `shared/events/event_bus.py`        | Standalone library for Python hooks|
+
+Both implementations use the **same file format** and are fully interoperable.
+
+## Event File Format
+
+Every event file contains these fields:
+
+```json
+{
+  "_producer": "ignition",
+  "source": "ignition",
+  "type": "plan-created",
+  "payload": {
+    "path": "projects/my-app/PLANNING.md",
+    "projectType": "application",
+    "title": "My App"
+  },
+  "timestamp": "2026-03-26T12:00:00.000Z"
+}
+```
+
+| Field        | Type   | Description                                        |
+|--------------|--------|----------------------------------------------------|
+| `_producer`  | string | Module ID that emitted the event                   |
+| `source`     | string | Same as `_producer` (kept for backward compat)     |
+| `type`       | string | Event type identifier                              |
+| `payload`    | object | Event-specific data                                |
+| `timestamp`  | string | ISO 8601 timestamp of emission                     |
+
+Filename format: `{iso-timestamp}-{sequence}-{source}-{type}.json`
+
+## Event Types
+
+| Event            | Producer   | Consumers         | Payload                                          |
+|------------------|------------|--------------------|--------------------------------------------------|
+| `plan-created`   | ignition   | drive, momentum    | `path`, `projectType`, `title`                   |
+| `phase-progress` | drive      | momentum           | `phase`, `status`, `planPath`, `completedTasks`, `totalTasks` |
+| `audit-complete` | radar      | momentum           | `findings`, `critical`, `report`                 |
+
+## Using the Python Event Bus
+
+### Emitting Events
+
+```python
+from event_bus import emit, emit_plan_created
+
+# Generic emit
+emit("ignition", "plan-created", {
+    "path": "projects/my-app/PLANNING.md",
+    "projectType": "application",
+    "title": "My App",
+})
+
+# Convenience wrapper (same result)
+emit_plan_created("projects/my-app/PLANNING.md", "application", "My App")
+```
+
+### Consuming Events
+
+```python
+from event_bus import consume
+
+# Consume specific event types (moves matched files to archive/)
+events = consume(event_types=["audit-complete", "phase-progress"])
+for item in events:
+    event = item["event"]
+    print(f"Got {event['type']} from {event['source']}: {event['payload']}")
+```
+
+### Peeking Without Consuming
+
+```python
+from event_bus import peek
+
+# Read events without archiving them
+pending = peek(event_types=["plan-created"])
+print(f"{len(pending)} plan-created events pending")
+```
+
+### Cleanup
+
+```python
+from event_bus import cleanup
+
+# Remove events older than 7 days, cap archive size
+cleanup(max_age_days=7)
+```
+
+### Producer Validation
+
+Events are validated against `~/.accel/manifest.json`. Only modules listed in the manifest can emit events. Invalid producers are moved to the `errors/` directory.
+
+```python
+from event_bus import validate_producer
+
+error = validate_producer({"_producer": "unknown-module"})
+if error:
+    print(f"Rejected: {error}")
+```
+
+## Using from Python Hooks (No Import)
+
+If your hook cannot import the shared library (e.g., different working directory), you can inline the same logic. The Momentum pulse hook demonstrates this pattern -- it reads and archives event files directly using only stdlib `json` and `pathlib`:
+
+```python
+from pathlib import Path
+import json
+
+EVENTS_DIR = Path.home() / ".accel" / "events"
+ARCHIVE_DIR = EVENTS_DIR / "archive"
+
+def consume_events(event_types):
+    if not EVENTS_DIR.is_dir():
+        return []
+    ARCHIVE_DIR.mkdir(parents=True, exist_ok=True)
+    consumed = []
+    for f in sorted(EVENTS_DIR.glob("*.json")):
+        event = json.loads(f.read_text())
+        if event.get("type") in event_types:
+            consumed.append(event)
+            f.rename(ARCHIVE_DIR / f.name)
+    return consumed
+```
+
+## Integration Flow
+
+```
+Ignition (ideate)
+    │  writes PLANNING.md
+    │  emits plan-created event
+    ▼
+Drive (next invocation)
+    │  consumes plan-created, adopts plan
+    │  emits phase-progress events as work proceeds
+    ▼
+Momentum (pulse hook, every session)
+    │  consumes phase-progress -> updates state.json
+    │  consumes audit-complete -> creates backlog items
+    │  consumes plan-created -> displays in pulse output
+    ▼
+Radar (audit)
+    │  emits audit-complete event
+    └──► Momentum picks it up on next pulse
+```
+
+## Design Decisions
+
+- **File-based, not socket-based**: Modules run in separate sessions. File-based events survive across sessions and require no daemon.
+- **At-most-once delivery**: Events are moved (renamed) to `archive/` on consumption. If a consumer crashes mid-processing, the event is already archived.
+- **Producer validation**: Prevents orphaned events from uninstalled modules. The manifest is the source of truth.
+- **Language-agnostic**: JSON files in a known directory. Any language can participate.
+- **Automatic cleanup**: Old events and oversized archives are pruned to prevent disk bloat.