jumbo-cli 1.0.0-beta.0

package/README.md

@@ -0,0 +1,261 @@
+<p style="width:100%; background-color:#F4D078; padding:9px 9px" align="center">
+  This project is in beta. Non-backward compatible changes could be introduced. Please post issues if you discover anything and contributions are welcome.
+</p>
+
+<p align="center">
+  <img src="jumbo-logo.svg" alt="Jumbo" width="200">
+</p>
+
+<h1 align="center">Jumbo - Memory for Coding Agents</h1>
+
+<p align="center">
+  Use Jumbo. <br>
+  Focus on goals, not context.
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#usage">Usage</a> •
+  <a href="#faqs">FAQs</a>
+</p>
+
+---
+
+## Can we address the elephant in the room?
+
+Face it, working with coding agents is not ALL fun.  
+One step back for every two forward is not a productivity boost.  
+It's a hassle.
+
+Context engineering alleviates the pain, but has you focused on the wrong things.
+
+
+## How does Jumbo help?
+
+Jumbo is a CLI tool that gives your coding agent memory like an... well, <span style="font-size: 1.5rem;">🐘</span>. <br>
+It keeps your agent on track, and you focused on what you want to build.
+
+- **Tracks project details**  
+Important aspects of you project are stored, retrievable, and mutable.  
+<sub>(see below)</sub>
+
+- **Delivers optimized context**  
+Agents receive the context they need to work aligned with YOUR criteria.
+
+- **Portable**  
+Switch models, or move from CLI to IDE, without interruption. Jumbo stays with you project and knows exactly where you left off.
+
+- **Extends context windows**  
+Optimal context delivery lets agents work longer.
+
+- **Automatic**  
+Hooks into your agent session and orchestrates the flow. It just works.
+
+- **Full control**  
+Jumbo's memories are yours. Stay in control and manage your data directly from the terminal.
+
+- **Private**  
+All data stays local. Nothing leaves your machine.
+
+- **Fast**  
+No network calls. No lag. Works instantaneously.  
+
+
+## What's in the trunk?  
+Jumbo models memories as the following aggregates:
+
+- **Project**  
+What you are building and who it's for.
+- **Architecture**  
+Your solution design, structure and patterns applied.
+- **Components**  
+The parts comprising your solution and their roles.
+- **Dependencies**  
+What your project relies on.
+- **Decisions**  
+A history of why you chose what you chose.
+- **Guidelines**  
+The preferences, best practices, and the standards you adhere to.
+- **Invariants**  
+The rules you simply won't compromise on.
+- **Goals**  
+What you're working on—now, next and later.
+- **Sessions**  
+The state of the project.
+- **Context Packets**  
+Optimized context packets delivered to your AI agents.
+
+
+---
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g jumbo-cli
+
+# Initialize in your project
+jumbo project init
+```
+
+That's it. Fire up your coding agent. Work flows. Memories stick. Momentum builds.
+
+---
+
+## Initializing a Project
+
+Run `jumbo init` in your project root. This creates a `.jumbo/` directory with:
+
+- **Event store** — Append-only log of all project-knowledge
+- **FSDB** — Read-optimized views for fast querying
+- **Hook configuration** — Integration points for your AI tools
+
+### Hook Integration
+
+Hooks for popular AI agents are configured for session start, your agent receives a tiny project status—recently completed, active, and planned goals. When you start a goal, a comprehensive context packet is delivered with the details necessary for your agent to execute the implementation.
+
+---
+
+## Usage
+
+Jumbo organizes knowledge into a few key concepts:
+
+### Goals
+
+Track what you're working on:
+
+```bash
+jumbo goal add --objective "Implement user auth"
+jumbo goal start --goal-id <id>
+jumbo goal complete --goal-id <id>
+```
+
+### Decisions
+
+Capture architectural decisions your agent must respect:
+
+```bash
+jumbo decision add --title "CQRS for all data access" --rationale "Separate read/write models for scalability and clarity"
+```
+
+### Invariants
+
+Define non-negotiable rules—the lines your agent cannot cross:
+
+```bash
+jumbo invariant add --category "Architecture" --description "Common Closure Principle: classes that change together live together. No scattering related logic across modules."
+```
+
+### Components
+
+Track system components:
+
+```bash
+jumbo component add --name "AuthService" --description "Handles user authentication"
+```
+
+### Full Command Reference
+
+```
+PROJECT
+  audience add/remove/update    Manage target audiences
+  project init/update           Initialize and configure
+  value add/remove/update       Value propositions
+
+WORK
+  goal add/start/complete       Track goals and progress
+  goal block/unblock            Handle blockers
+  session start/end/pause       Manage work sessions
+
+SOLUTION
+  architecture define/update    System architecture
+  component add/update/remove   System components
+  decision add/reverse          Architectural decisions
+  dependency add/remove         Component dependencies
+  guideline add/remove          Execution guidelines
+  invariant add/remove          Non-negotiable rules
+```
+
+Run `jumbo --help` for the complete list.
+
+---
+
+## Dependencies
+
+Jumbo is built with:
+
+| Package | Purpose |
+|---------|---------|
+| better-sqlite3 | Local event store and projections |
+| commander | CLI framework |
+| chalk | Terminal styling |
+| yaml | Context serialization |
+| inversify | Dependency injection |
+| ulid | Time-sortable unique IDs |
+
+---
+
+## FAQs
+
+**How does jumbo integrate with my AI agent?**
+
+Through hooks. Your agent calls `jumbo session start` at the beginning of a session, and `jumbo` injects relevant project context. A richer context packet is delivered to the agent when it starts work on a goal. New insights are captured in the natural flow of your agent conversations.
+
+**What if I change agents or models?**
+
+Change agents and models at will. `jumbo` just picks up where you left off.
+
+**What coding agents does jumbo work with?**
+
+`jumbo` has been battle tested with Claude Code CLI, Gemini CLI, and Copilot CLI. More to be verified soon...
+
+**What IDEs are supported?**
+
+Theoretically, any IDE with an integrated coding agent should work. VS Code running GitHub Copilot has been tested and works well with all supported models. Cursor to be verified soon...
+
+**Where is data stored?**
+
+Locally, in `.jumbo/` within your project. Nothing leaves your machine unless you want it to.
+
+**Can I control what data Jumbo captures?**  
+
+Absolutely. You control how you want your agent to interact with Jumbo. Stay in-the-loop by approving each command, or run with pre-approved Jumbo commands for an automated experience.
+
+**Is Jumbo going to hijack my agent?**  
+
+Not at all. Jumbo prescribes an opinionated workflow that you can always bypass. It works alongside your agent to enhance its capabilities.  
+
+**Why not just use markdown files?**  
+
+Jumbo goes beyond static markdown files. It's an immutable event stream—capturing your entire project history, always current and auditable. You stay in your flow, never repeat yourself—only add new information when you need to. Markdown is a snapshot in time, Jumbo is your project's living memory.
+
+**Is there documentation?**
+It's on it's way...  
+In the meantime, the CLI will guide you in getting started. In addition, the help command <code>jumbo --help</code> provides a comprehensive overview of all available commands and options with examples.
+
+**Can I share context across a team?**
+
+Not yet. A teams version is coming soon.
+
+If you're feeling bold, you can try committing `.jumbo/` directory to your repository—not recommended though. Without very tight coordination you're bound to encounter problems. `jumbo` uses Event Sourcing under the hood, working asynchronously will definitely result in out-of-sequence events. 
+
+<!-- **Why not just use comments or docs?**
+
+You can do that, but the amount of context window consumed while your agent crawls your repo for background information leaves little context budget for executing the task precisely. You risk auto-compression and the agent going awry. gure out how to execute a given task, leaves little   They also don't capture vital lessons learned in the context of your 'conversations'  Jumbo is dynamic—it knows what you're working on *right now* and surfaces relevant context automatically. Jumbo let's you focus on what you want to achieve, the background just comes automatically.
+
+**Does this replace documentation?**
+
+Yes. Jumbo makes documentation obsolete. Jumbo captures working memories: project knowledge, architecture details, coding patterns, invariant, decisions, goals, blockers, session data and relations between all of it. It's richer than documentation, never outdated, served up to the your coding agent when it needs it, and available to you when you want it. -->
+
+---
+
+## License
+
+[AGPL-3.0](LICENSE)
+
+---
+
+<p align="center">
+  Built for developers who are tired of repeating themselves.
+</p>

package/dist/application/cli-metadata/query/ICliMetadataReader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Port interface for reading CLI metadata.
+ * Provides access to build-time metadata about the CLI itself.
+ */
+export interface CliMetadataView {
+    version: string;
+}
+export interface ICliMetadataReader {
+    /**
+     * Retrieves the CLI metadata including version.
+     */
+    getMetadata(): CliMetadataView;
+}
+//# sourceMappingURL=ICliMetadataReader.d.ts.map

package/dist/application/cli-metadata/query/ICliMetadataReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICliMetadataReader.d.ts","sourceRoot":"","sources":["../../../../src/application/cli-metadata/query/ICliMetadataReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,IAAI,eAAe,CAAC;CAChC"}

package/dist/application/cli-metadata/query/ICliMetadataReader.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Port interface for reading CLI metadata.
+ * Provides access to build-time metadata about the CLI itself.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICliMetadataReader.js.map

package/dist/application/cli-metadata/query/ICliMetadataReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICliMetadataReader.js","sourceRoot":"","sources":["../../../../src/application/cli-metadata/query/ICliMetadataReader.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommand.d.ts

@@ -0,0 +1,16 @@
+/**
+ * RebuildDatabase command
+ *
+ * Rebuilds the materialized views (SQLite database) by replaying all events
+ * from the event store. This is useful for:
+ * - Recovering from database corruption
+ * - Migrating to a new schema
+ * - Fixing projection bugs by replaying with corrected handlers
+ */
+export interface RebuildDatabaseCommand {
+    /**
+     * If true, skip confirmation prompt (for automated scripts)
+     */
+    skipConfirmation?: boolean;
+}
+//# sourceMappingURL=RebuildDatabaseCommand.d.ts.map

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebuildDatabaseCommand.d.ts","sourceRoot":"","sources":["../../../../../src/application/maintenance/db/rebuild/RebuildDatabaseCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommand.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RebuildDatabaseCommand.js.map

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebuildDatabaseCommand.js","sourceRoot":"","sources":["../../../../../src/application/maintenance/db/rebuild/RebuildDatabaseCommand.ts"],"names":[],"mappings":""}

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.d.ts

@@ -0,0 +1,25 @@
+import { RebuildDatabaseCommand } from "./RebuildDatabaseCommand.js";
+import { IEventStore } from "../../../shared/persistence/IEventStore.js";
+import { IEventBus } from "../../../shared/messaging/IEventBus.js";
+/**
+ * Handler for rebuilding the database from the event store.
+ *
+ * Strategy:
+ * 1. Fetch all events from the event store (sorted by timestamp)
+ * 2. Publish each event through the event bus
+ * 3. Registered projection handlers rebuild materialized views
+ *
+ * Note: Database must be cleared before calling this handler.
+ * The bootstrap process handles database initialization and migrations.
+ */
+export declare class RebuildDatabaseCommandHandler {
+    private readonly eventStore;
+    private readonly eventBus;
+    constructor(eventStore: IEventStore, eventBus: IEventBus);
+    handle(command: RebuildDatabaseCommand): Promise<RebuildDatabaseResult>;
+}
+export interface RebuildDatabaseResult {
+    eventsReplayed: number;
+    success: boolean;
+}
+//# sourceMappingURL=RebuildDatabaseCommandHandler.d.ts.map

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebuildDatabaseCommandHandler.d.ts","sourceRoot":"","sources":["../../../../../src/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,qBAAa,6BAA6B;IAEtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,SAAS;IAGhC,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAkB9E;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RebuildDatabaseCommandHandler = void 0;
+/**
+ * Handler for rebuilding the database from the event store.
+ *
+ * Strategy:
+ * 1. Fetch all events from the event store (sorted by timestamp)
+ * 2. Publish each event through the event bus
+ * 3. Registered projection handlers rebuild materialized views
+ *
+ * Note: Database must be cleared before calling this handler.
+ * The bootstrap process handles database initialization and migrations.
+ */
+class RebuildDatabaseCommandHandler {
+    constructor(eventStore, eventBus) {
+        this.eventStore = eventStore;
+        this.eventBus = eventBus;
+    }
+    async handle(command) {
+        // Get all events sorted by timestamp
+        const events = await this.eventStore.getAllEvents();
+        let processedCount = 0;
+        // Replay each event through the event bus
+        // Projection handlers subscribed to the bus will rebuild views
+        for (const event of events) {
+            await this.eventBus.publish(event);
+            processedCount++;
+        }
+        return {
+            eventsReplayed: processedCount,
+            success: true,
+        };
+    }
+}
+exports.RebuildDatabaseCommandHandler = RebuildDatabaseCommandHandler;
+//# sourceMappingURL=RebuildDatabaseCommandHandler.js.map

package/dist/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RebuildDatabaseCommandHandler.js","sourceRoot":"","sources":["../../../../../src/application/maintenance/db/rebuild/RebuildDatabaseCommandHandler.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;GAUG;AACH,MAAa,6BAA6B;IACxC,YACmB,UAAuB,EACvB,QAAmB;QADnB,eAAU,GAAV,UAAU,CAAa;QACvB,aAAQ,GAAR,QAAQ,CAAW;IACnC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,OAA+B;QAC1C,qCAAqC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QAEpD,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,0CAA0C;QAC1C,+DAA+D;QAC/D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACnC,cAAc,EAAE,CAAC;QACnB,CAAC;QAED,OAAO;YACL,cAAc,EAAE,cAAc;YAC9B,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF;AAxBD,sEAwBC"}

package/dist/application/project-knowledge/audience-pains/AudiencePainView.d.ts

@@ -0,0 +1,19 @@
+/**
+ * AudiencePainView - Materialized view for audience pain projections.
+ *
+ * Represents the current state of an AudiencePain aggregate as a queryable view.
+ * Used for read operations without rehydrating from event history.
+ */
+import { UUID, ISO8601 } from "../../../domain/shared/BaseEvent.js";
+import { AudiencePainStatusType } from "../../../domain/project-knowledge/audience-pains/Constants.js";
+export interface AudiencePainView {
+    painId: UUID;
+    title: string;
+    description: string;
+    status: AudiencePainStatusType;
+    resolvedAt: ISO8601 | null;
+    version: number;
+    createdAt: ISO8601;
+    updatedAt: ISO8601;
+}
+//# sourceMappingURL=AudiencePainView.d.ts.map

package/dist/application/project-knowledge/audience-pains/AudiencePainView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudiencePainView.d.ts","sourceRoot":"","sources":["../../../../src/application/project-knowledge/audience-pains/AudiencePainView.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAEvG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/application/project-knowledge/audience-pains/AudiencePainView.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * AudiencePainView - Materialized view for audience pain projections.
+ *
+ * Represents the current state of an AudiencePain aggregate as a queryable view.
+ * Used for read operations without rehydrating from event history.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AudiencePainView.js.map

package/dist/application/project-knowledge/audience-pains/AudiencePainView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudiencePainView.js","sourceRoot":"","sources":["../../../../src/application/project-knowledge/audience-pains/AudiencePainView.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AddAudiencePain Command
+ *
+ * Command to add a new audience pain point to the project.
+ */
+export interface AddAudiencePainCommand {
+    title: string;
+    description: string;
+}
+//# sourceMappingURL=AddAudiencePainCommand.d.ts.map

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddAudiencePainCommand.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * AddAudiencePain Command
+ *
+ * Command to add a new audience pain point to the project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AddAudiencePainCommand.js.map

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddAudiencePainCommand.js","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AddAudiencePainCommand.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AddAudiencePainCommandHandler - Command handler for audience pain addition.
+ *
+ * This handler:
+ * 1. Creates a new AudiencePain aggregate with unique ID
+ * 2. Executes domain logic (add)
+ * 3. Persists event to event store
+ * 4. Publishes event to event bus for projection updates
+ */
+import { AddAudiencePainCommand } from "./AddAudiencePainCommand.js";
+import { IAudiencePainAddedEventWriter } from "./IAudiencePainAddedEventWriter.js";
+import { IEventBus } from "../../../shared/messaging/IEventBus.js";
+import { UUID } from "../../../../domain/shared/BaseEvent.js";
+export declare class AddAudiencePainCommandHandler {
+    private readonly eventWriter;
+    private readonly eventBus;
+    constructor(eventWriter: IAudiencePainAddedEventWriter, eventBus: IEventBus);
+    execute(command: AddAudiencePainCommand): Promise<{
+        painId: UUID;
+    }>;
+}
+//# sourceMappingURL=AddAudiencePainCommandHandler.d.ts.map

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddAudiencePainCommandHandler.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAE9D,qBAAa,6BAA6B;IAEtC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,WAAW,EAAE,6BAA6B,EAC1C,QAAQ,EAAE,SAAS;IAGhC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC;CAoB1E"}

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * AddAudiencePainCommandHandler - Command handler for audience pain addition.
+ *
+ * This handler:
+ * 1. Creates a new AudiencePain aggregate with unique ID
+ * 2. Executes domain logic (add)
+ * 3. Persists event to event store
+ * 4. Publishes event to event bus for projection updates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddAudiencePainCommandHandler = void 0;
+const AudiencePain_js_1 = require("../../../../domain/project-knowledge/audience-pains/AudiencePain.js");
+class AddAudiencePainCommandHandler {
+    constructor(eventWriter, eventBus) {
+        this.eventWriter = eventWriter;
+        this.eventBus = eventBus;
+    }
+    async execute(command) {
+        // Generate unique ID for new pain
+        const painId = `pain-${Date.now()}-${Math.random()
+            .toString(36)
+            .substr(2, 9)}`;
+        // 1. Create new aggregate
+        const pain = AudiencePain_js_1.AudiencePain.create(painId);
+        // 2. Domain logic produces event
+        const event = pain.add(command.title, command.description);
+        // 3. Persist event to file store
+        await this.eventWriter.append(event);
+        // 4. Publish event to bus (projections will update via subscriptions)
+        await this.eventBus.publish(event);
+        return { painId };
+    }
+}
+exports.AddAudiencePainCommandHandler = AddAudiencePainCommandHandler;
+//# sourceMappingURL=AddAudiencePainCommandHandler.js.map

package/dist/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddAudiencePainCommandHandler.js","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AddAudiencePainCommandHandler.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAKH,yGAAmG;AAGnG,MAAa,6BAA6B;IACxC,YACmB,WAA0C,EAC1C,QAAmB;QADnB,gBAAW,GAAX,WAAW,CAA+B;QAC1C,aAAQ,GAAR,QAAQ,CAAW;IACnC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,OAA+B;QAC3C,kCAAkC;QAClC,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE;aAC/C,QAAQ,CAAC,EAAE,CAAC;aACZ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAU,CAAC;QAE1B,0BAA0B;QAC1B,MAAM,IAAI,GAAG,8BAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzC,iCAAiC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAE3D,iCAAiC;QACjC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAErC,sEAAsE;QACtE,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnC,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CACF;AA1BD,sEA0BC"}

package/dist/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.d.ts

@@ -0,0 +1,15 @@
+import { IEventHandler } from "../../../shared/messaging/IEventHandler.js";
+import { BaseEvent } from "../../../../domain/shared/BaseEvent.js";
+import { IAudiencePainAddedProjector } from "./IAudiencePainAddedProjector.js";
+/**
+ * Event handler for AudiencePainAddedEvent event.
+ *
+ * Application layer handler that orchestrates projection updates
+ * when a new audience pain is added. Subscribes to AudiencePainAddedEvent via event bus.
+ */
+export declare class AudiencePainAddedEventHandler implements IEventHandler {
+    private readonly projector;
+    constructor(projector: IAudiencePainAddedProjector);
+    handle(event: BaseEvent): Promise<void>;
+}
+//# sourceMappingURL=AudiencePainAddedEventHandler.d.ts.map

package/dist/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudiencePainAddedEventHandler.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E;;;;;GAKG;AACH,qBAAa,6BAA8B,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,2BAA2B;IAE7D,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9C"}

package/dist/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudiencePainAddedEventHandler = void 0;
+/**
+ * Event handler for AudiencePainAddedEvent event.
+ *
+ * Application layer handler that orchestrates projection updates
+ * when a new audience pain is added. Subscribes to AudiencePainAddedEvent via event bus.
+ */
+class AudiencePainAddedEventHandler {
+    constructor(projector) {
+        this.projector = projector;
+    }
+    async handle(event) {
+        const audiencePainAddedEvent = event;
+        await this.projector.applyAudiencePainAdded(audiencePainAddedEvent);
+    }
+}
+exports.AudiencePainAddedEventHandler = AudiencePainAddedEventHandler;
+//# sourceMappingURL=AudiencePainAddedEventHandler.js.map

package/dist/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudiencePainAddedEventHandler.js","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/AudiencePainAddedEventHandler.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,MAAa,6BAA6B;IACxC,YAA6B,SAAsC;QAAtC,cAAS,GAAT,SAAS,CAA6B;IAAG,CAAC;IAEvE,KAAK,CAAC,MAAM,CAAC,KAAgB;QAC3B,MAAM,sBAAsB,GAAG,KAA+B,CAAC;QAC/D,MAAM,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;IACtE,CAAC;CACF;AAPD,sEAOC"}

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.d.ts

@@ -0,0 +1,10 @@
+import { BaseEvent } from "../../../../domain/shared/BaseEvent.js";
+import { AppendResult } from "../../../shared/persistence/IEventStore.js";
+/**
+ * Port interface for writing AudiencePainAdded events to the event store.
+ * Used by AddAudiencePainCommandHandler to persist domain events.
+ */
+export interface IAudiencePainAddedEventWriter {
+    append(event: BaseEvent & Record<string, any>): Promise<AppendResult>;
+}
+//# sourceMappingURL=IAudiencePainAddedEventWriter.d.ts.map

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudiencePainAddedEventWriter.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACvE"}

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAudiencePainAddedEventWriter.js.map

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudiencePainAddedEventWriter.js","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/IAudiencePainAddedEventWriter.ts"],"names":[],"mappings":""}

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.d.ts

@@ -0,0 +1,9 @@
+import { AudiencePainAddedEvent } from "../../../../domain/project-knowledge/audience-pains/add/AudiencePainAddedEvent.js";
+/**
+ * Port interface for projecting AudiencePainAddedEvent events to the read model.
+ * Used by AudiencePainAddedEventHandler to update the projection store.
+ */
+export interface IAudiencePainAddedProjector {
+    applyAudiencePainAdded(event: AudiencePainAddedEvent): Promise<void>;
+}
+//# sourceMappingURL=IAudiencePainAddedProjector.d.ts.map

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudiencePainAddedProjector.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mFAAmF,CAAC;AAE3H;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE"}

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAudiencePainAddedProjector.js.map

package/dist/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudiencePainAddedProjector.js","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/add/IAudiencePainAddedProjector.ts"],"names":[],"mappings":""}

package/dist/application/project-knowledge/audience-pains/query/IAudiencePainContextReader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Port interface for reading audience pains in query contexts.
+ * Used by GetSessionStartContextQueryHandler for session orientation.
+ */
+import { AudiencePainView } from "../AudiencePainView.js";
+export interface IAudiencePainContextReader {
+    /**
+     * Retrieves all active (non-resolved) audience pains.
+     * @returns Array of active audience pain views
+     */
+    findAllActive(): Promise<AudiencePainView[]>;
+}
+//# sourceMappingURL=IAudiencePainContextReader.d.ts.map

package/dist/application/project-knowledge/audience-pains/query/IAudiencePainContextReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudiencePainContextReader.d.ts","sourceRoot":"","sources":["../../../../../src/application/project-knowledge/audience-pains/query/IAudiencePainContextReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAC9C"}