jumbo-cli 3.1.0 → 3.3.0

package/README.md

@@ -57,9 +57,9 @@ Those solve the core problems. These make Jumbo pleasant to use:
 > npm i -g jumbo-cli
 ```
 
-2. Browse your project folder and initialize Jumbo
+2. Browse your project folder and run Jumbo
 ``` bash
-> jumbo init
+> jumbo
 ```
 Jumbo will guide you in getting started.
 
@@ -193,7 +193,7 @@ Spread some ❤️ and sponsor the projects or buy them a cup of coffee. I have.
 <details>
 <summary>How does jumbo integrate with my AI agent?</summary>
 
-Through hooks, with fallback to AGENTS.md. 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.
+Through hooks, with fallback to AGENTS.md. Your agent calls `jumbo session start` at the beginning of a session, and Jumbo returns a workflow router. The selected workflow then loads the relevant context packet, such as `jumbo project show --northstar --format json` for goal design or `jumbo goal start --id <id>` for implementation. New insights are captured in the natural flow of your agent conversations.
 </details>
 
 <details>

package/assets/skills/codify-jumbo-goal/SKILL.md

@@ -81,12 +81,6 @@ jumbo dependency update --id <id> --contract "..."
 jumbo dependency remove --id <id>
 ```
 
-#### Architecture
-Did this work change the architecture style, principles, or patterns?
-```bash
-jumbo architecture update --style "..." --principles "..."
-```
-
 #### Relations
 Should any new relations be established between entities touched by this goal?
 ```bash

package/assets/skills/define-jumbo-goals/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: define-jumbo-goals
-description: Use when defining new Jumbo goals from user requests. Guides discovery, decomposition, and goal authoring to produce goals with explicit implementation instructions that minimize token usage during autonomous execution.
+description: Add Jumbo goals liberally to decompose objectives into finite units of work with bounded context. Use when defining new Jumbo goals from user requests, or to augment your own work to maintain scope while ensuring complementary work is registered.
 ---
 
 # Define Jumbo Goals
 
-**Prompt:** Analyze a user request, discover the architectural context required, decompose the work into right-sized goals, and author each goal with precise objectives, verifiable criteria, and explicit scope — so that refinement and implementation proceed with minimal exploration overhead.
+**Prompt:** Analyze the primary objective to discover the architectural context required, decompose the work into right-sized goals, and author each goal with precise objectives, verifiable criteria, and explicit scope — so that refinement and implementation proceed with minimal exploration overhead.
 
 ## Why Definition Quality Matters
 
@@ -15,8 +15,17 @@ A goal's definition determines everything downstream. During refinement, the age
 
 ## Protocol
 
-### 1. Understand the Request
+### 1. Align Goal and Project Purpose
 
+Start by getting oriented with the overall project purpose (use a cached response if previously run in this session):
+
+```bash
+jumbo project show --northstar
+```
+
+The initiative to define a new goal could be self-driven, or have eminated from the user:
+
+#### If from the User
 Extract the user's intent through conversation. Identify:
 
 - **What** needs to change (feature, fix, refactor, infrastructure)
@@ -25,31 +34,27 @@ Extract the user's intent through conversation. Identify:
 
 If the request is ambiguous, ask clarifying questions before proceeding. Do not guess intent.
 
-### 2. Discover Architectural Context
+#### If Self-Driven
+Ensure the initiative is not in conflict with the project purpose. Abandon the initiative if it is, or adjust if slight fitting would align it.
+
+
+### 2. Understand Context
 
 Before writing any goal, survey the project to understand what exists:
 
 ```bash
-jumbo architecture view
-jumbo components search --query "<relevant domain terms>"
+jumbo components search --q "<query terms>"
 jumbo components search --type <likely-type>
-jumbo invariants list
-jumbo guidelines list
-jumbo decisions list
-jumbo dependencies list
+jumbo invariants search --q "<query terms>"
+jumbo guidelines search --q "<query terms>"
+jumbo decisions search --q "<query terms>"
+jumbo dependencies search --q "<query terms>"
 ```
 
 This discovery serves two purposes:
 - **Inform decomposition**: Understanding the system's boundaries, patterns, and constraints reveals the natural seams along which to split work.
 - **Inform criteria**: Existing invariants, decisions, and patterns dictate what "correct" looks like.
 
-If you encounter components, patterns, or decisions that exist in the codebase but are not registered in Jumbo, register them now — before writing goals. Accurate entity coverage produces better relations during refinement:
-
-```bash
-jumbo component add --name "ExistingService" --description "What it does"
-jumbo decision add --title "Existing pattern" --rationale "Why it was chosen" --context "Background"
-```
-
 Also explore the codebase directly to understand current implementation:
 
 ```bash
@@ -123,11 +128,6 @@ Rules:
 - Include a testing criterion — specify what tests exist and what they verify.
 - If a refactoring skill applies, add `skill:<skill-name>` as a criterion.
 
-**Criteria count guidance:**
-- Trivial goal (rename, config change): 2-3 criteria
-- Standard goal (new feature, refactor): 5-8 criteria
-- Complex goal (cross-cutting concern): 8-12 criteria
-
 #### Scope
 
 Scope tells the implementing agent where to work and where not to touch.
@@ -161,7 +161,6 @@ Chaining is the primary mechanism for **long-running autonomous sessions without
 
 **When to chain:**
 - Work decomposes into ordered steps where each builds on the prior (e.g., "define port abstraction" → "implement adapter" → "wire into CLI").
-- The user wants to hand off a multi-goal workstream and return when it is all done.
 - The combined work would exceed comfortable context limits if attempted as a single goal.
 
 **When NOT to chain:**
@@ -179,7 +178,7 @@ After all goals are registered, verify:
 - [ ] Goal sequencing reflects actual dependencies (not just aesthetic ordering)
 - [ ] No single goal is so large it risks context compaction during implementation
 - [ ] No goal duplicates work from another goal
-- [ ] The full set of goals covers the user's original request completely
+- [ ] The full set of goals covers the initial objective completely
 
 ## Anti-Patterns
 
@@ -199,4 +198,4 @@ After all goals are registered, verify:
 2. **Never write criteria the reviewing agent cannot verify.** If a criterion requires subjective judgment ("clean code", "good performance"), replace it with a measurable statement ("no function exceeds 30 lines", "response time under 200ms for 1000 records").
 3. **Never skip scope.** Every goal must have scope-in. Most goals should have scope-out. Unbounded scope invites unbounded implementation.
 4. **Always decompose before defining.** Resist the urge to create one large goal. Think in shippable increments.
-5. **Always verify goal coverage.** The union of all goals must fully address the user's request. Gaps between goals are gaps in delivery.
+5. **Always verify goal coverage.** The union of all goals must fully address the starting objective. Gaps between goals are gaps in delivery.

package/assets/skills/jumbo-add-component/SKILL.md

@@ -7,6 +7,15 @@ description: Use liberally when you create, discover, or modify a software compo
 
 Register a software component with Jumbo when you create one, discover an unregistered one, or significantly change one's responsibility.
 
+## Before Adding
+Check for an existing component to avoid duplication. Consider renaming, updating, or deprecating and replacing a previously registered component before registering a new one.
+
+Use the search subcommand to locate previously registered components:
+
+```bash
+jumbo components search -q <query>
+```
+
 ## Command Syntax
 
 ```bash

package/assets/skills/jumbo-add-decision/SKILL.md

@@ -7,6 +7,15 @@ description: Use liberally when you make an architectural choice, select a techn
 
 Register an architectural decision with Jumbo when you choose one approach over alternatives. Decisions explain **why** the codebase looks the way it does — without them, future agents may reverse your choices or repeat your analysis.
 
+## Before Adding
+Check for an existing decision to avoid duplication. Consider reversing, updating, or superseding a previously registered decision before registering a new one.
+
+Use the search subcommand to locate previously registered decisions:
+
+```bash
+jumbo decisions search -q <query>
+```
+
 ## Command Syntax
 
 ```bash

package/assets/skills/jumbo-add-dependency/SKILL.md

@@ -7,6 +7,15 @@ description: Use liberally when you introduce, discover, or upgrade a third-part
 
 Register a third-party dependency with Jumbo when you add a new package, discover an unregistered one, or integrate with an external service.
 
+## Before Adding
+Check for an existing dependency to avoid duplication. Consider renaming, updating, or deprecating and replacing a previously registered dependency before registering a new one.
+
+Use the search subcommand to locate previously registered dependencies:
+
+```bash
+jumbo dependencies search -q <query>
+```
+
 ## Command Syntax
 
 ```bash

package/assets/skills/jumbo-add-guideline/SKILL.md

@@ -9,6 +9,15 @@ Register a guideline with Jumbo when the user states a preference about how work
 
 **Important:** Guidelines must be **generally applicable** to the project. Do not word them for a specific use case, goal, or task. A guideline that only applies to one situation belongs in a goal's criteria, not in the guideline registry.
 
+## Before Adding
+Check for an existing guideline to avoid duplication. Consider removing, or updating, a previously registered guideline before registering a new one.
+
+Use the search subcommand to locate previously registered guidelines:
+
+```bash
+jumbo guidelines search -q <query>
+```
+
 ## Command Syntax
 
 ```bash

package/assets/skills/jumbo-add-invariant/SKILL.md

@@ -9,6 +9,15 @@ Register an invariant with Jumbo when you discover a non-negotiable constraint
 
 **Important:** Invariants must be **generally applicable** to the project. Do not word them for a specific use case, goal, or task. An invariant that only applies during one piece of work belongs in a goal's criteria, not in the invariant registry. If you find yourself writing "when working on X" or "for the Y feature", it is not an invariant.
 
+## Before Adding
+Check for an existing invariant to avoid duplication. Consider reversing, updating, or superseding a previously registered invariant before registering a new one.
+
+Use the search subcommand to locate previously registered invariants:
+
+```bash
+jumbo invariants search -q <query>
+```
+
 ## Command Syntax
 
 ```bash

package/assets/skills/jumbo-design-goal/SKILL.md

@@ -18,7 +18,7 @@ Definition without alignment produces goals that solve the wrong problem or miss
 Before discussing the goal, load the project's north-star context:
 
 ```bash
-jumbo architecture view
+jumbo project show --northstar
 ```
 
 Also extract the `projectContext` from your session start output. From these two sources, note:

package/assets/skills/refine-jumbo-goals/SKILL.md

@@ -28,12 +28,12 @@ You MUST explore ALL entity categories to build a complete picture of available
 ```bash
 jumbo invariants list
 jumbo guidelines list
-jumbo decisions list
-jumbo dependencies list
-jumbo architecture view
+jumbo decisions search -q <query>
+jumbo dependencies search -q <query>
+jumbo components search -q <query>
 ```
 
-For **components**, use targeted searches instead of dumping the full list. Extract keywords from the goal's objective and criteria, then search:
+Here are some examples demonstrated various ways to search for components:
 
 ```bash
 # Search by name (substring or wildcard)

package/dist/application/agents/AgentInvocation.d.ts

@@ -0,0 +1,10 @@
+export interface AgentInvocation {
+    readonly agentId: string;
+    readonly prompt: string;
+}
+export interface AgentInvocationResult {
+    readonly exitCode: number;
+    readonly stdout?: string;
+    readonly stderr?: string;
+}
+//# sourceMappingURL=AgentInvocation.d.ts.map

package/dist/application/agents/AgentInvocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentInvocation.d.ts","sourceRoot":"","sources":["../../../src/application/agents/AgentInvocation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/application/agents/AgentInvocation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AgentInvocation.js.map

package/dist/application/agents/AgentInvocation.js.map

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

package/dist/application/agents/IAgentGateway.d.ts

@@ -0,0 +1,5 @@
+import { AgentInvocation, AgentInvocationResult } from "./AgentInvocation.js";
+export interface IAgentGateway {
+    invoke(invocation: AgentInvocation): Promise<AgentInvocationResult>;
+}
+//# sourceMappingURL=IAgentGateway.d.ts.map

package/dist/application/agents/IAgentGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAgentGateway.d.ts","sourceRoot":"","sources":["../../../src/application/agents/IAgentGateway.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE"}

package/dist/application/agents/IAgentGateway.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IAgentGateway.js.map

package/dist/application/agents/IAgentGateway.js.map

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

package/dist/application/context/decisions/get/IDecisionViewReader.d.ts

@@ -3,6 +3,7 @@
  * Used by ListDecisionsQueryHandler to retrieve decision list with filtering.
  */
 import { DecisionView } from "../DecisionView.js";
+import type { DecisionSearchCriteria } from "../search/DecisionSearchCriteria.js";
 export type DecisionStatusFilter = "active" | "superseded" | "reversed" | "all";
 export interface IDecisionViewReader {
     /**
@@ -17,5 +18,11 @@ export interface IDecisionViewReader {
      * @returns Array of decision views ordered by creation date (newest first)
      */
     findByIds(ids: string[]): Promise<DecisionView[]>;
+    /**
+     * Searches decisions by criteria with AND logic.
+     * @param criteria - Search filters (status exact, title substring, query across decision text fields)
+     * @returns Array of matching decision views ordered by creation date (newest first)
+     */
+    search(criteria: DecisionSearchCriteria): Promise<DecisionView[]>;
 }
 //# sourceMappingURL=IDecisionViewReader.d.ts.map

package/dist/application/context/decisions/get/IDecisionViewReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IDecisionViewReader.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/get/IDecisionViewReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACnD"}
+{"version":3,"file":"IDecisionViewReader.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/get/IDecisionViewReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAElD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACnE"}

package/dist/application/context/decisions/search/DecisionSearchCriteria.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DecisionSearchCriteria - Search filter for querying decisions.
+ *
+ * All fields are optional. When multiple fields are specified,
+ * they are combined with AND logic.
+ *
+ * - status: exact match, or all for all decisions
+ * - title: substring match, or wildcard with * (e.g. Output*, *Boundary)
+ * - query: substring match across decision text fields (supports * wildcards)
+ */
+import type { DecisionStatusFilter } from "../get/IDecisionViewReader.js";
+export interface DecisionSearchCriteria {
+    readonly status?: DecisionStatusFilter;
+    readonly title?: string;
+    readonly query?: string;
+}
+//# sourceMappingURL=DecisionSearchCriteria.d.ts.map

package/dist/application/context/decisions/search/DecisionSearchCriteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionSearchCriteria.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/DecisionSearchCriteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/application/context/decisions/search/DecisionSearchCriteria.js

@@ -0,0 +1,12 @@
+/**
+ * DecisionSearchCriteria - Search filter for querying decisions.
+ *
+ * All fields are optional. When multiple fields are specified,
+ * they are combined with AND logic.
+ *
+ * - status: exact match, or all for all decisions
+ * - title: substring match, or wildcard with * (e.g. Output*, *Boundary)
+ * - query: substring match across decision text fields (supports * wildcards)
+ */
+export {};
+//# sourceMappingURL=DecisionSearchCriteria.js.map

package/dist/application/context/decisions/search/DecisionSearchCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecisionSearchCriteria.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/DecisionSearchCriteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/application/context/decisions/search/ISearchDecisionsGateway.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ISearchDecisionsGateway - Application-layer gateway interface
+ * defining the contract for searching decisions.
+ */
+import { SearchDecisionsRequest } from "./SearchDecisionsRequest.js";
+import { SearchDecisionsResponse } from "./SearchDecisionsResponse.js";
+export interface ISearchDecisionsGateway {
+    searchDecisions(request: SearchDecisionsRequest): Promise<SearchDecisionsResponse>;
+}
+//# sourceMappingURL=ISearchDecisionsGateway.d.ts.map

package/dist/application/context/decisions/search/ISearchDecisionsGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISearchDecisionsGateway.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/ISearchDecisionsGateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACpF"}

package/dist/application/context/decisions/search/ISearchDecisionsGateway.js

@@ -0,0 +1,6 @@
+/**
+ * ISearchDecisionsGateway - Application-layer gateway interface
+ * defining the contract for searching decisions.
+ */
+export {};
+//# sourceMappingURL=ISearchDecisionsGateway.js.map

package/dist/application/context/decisions/search/ISearchDecisionsGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISearchDecisionsGateway.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/ISearchDecisionsGateway.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/application/context/decisions/search/LocalSearchDecisionsGateway.d.ts

@@ -0,0 +1,14 @@
+/**
+ * LocalSearchDecisionsGateway - Application-layer gateway implementation
+ * that fulfills ISearchDecisionsGateway by delegating to IDecisionViewReader.search().
+ */
+import { IDecisionViewReader } from "../get/IDecisionViewReader.js";
+import { ISearchDecisionsGateway } from "./ISearchDecisionsGateway.js";
+import { SearchDecisionsRequest } from "./SearchDecisionsRequest.js";
+import { SearchDecisionsResponse } from "./SearchDecisionsResponse.js";
+export declare class LocalSearchDecisionsGateway implements ISearchDecisionsGateway {
+    private readonly decisionViewReader;
+    constructor(decisionViewReader: IDecisionViewReader);
+    searchDecisions(request: SearchDecisionsRequest): Promise<SearchDecisionsResponse>;
+}
+//# sourceMappingURL=LocalSearchDecisionsGateway.d.ts.map

package/dist/application/context/decisions/search/LocalSearchDecisionsGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSearchDecisionsGateway.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/LocalSearchDecisionsGateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,2BAA4B,YAAW,uBAAuB;IAEvE,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAGpD,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAIzF"}

package/dist/application/context/decisions/search/LocalSearchDecisionsGateway.js

@@ -0,0 +1,14 @@
+/**
+ * LocalSearchDecisionsGateway - Application-layer gateway implementation
+ * that fulfills ISearchDecisionsGateway by delegating to IDecisionViewReader.search().
+ */
+export class LocalSearchDecisionsGateway {
+    constructor(decisionViewReader) {
+        this.decisionViewReader = decisionViewReader;
+    }
+    async searchDecisions(request) {
+        const decisions = await this.decisionViewReader.search(request.criteria);
+        return { decisions };
+    }
+}
+//# sourceMappingURL=LocalSearchDecisionsGateway.js.map

package/dist/application/context/decisions/search/LocalSearchDecisionsGateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSearchDecisionsGateway.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/LocalSearchDecisionsGateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,OAAO,2BAA2B;IACtC,YACmB,kBAAuC;QAAvC,uBAAkB,GAAlB,kBAAkB,CAAqB;IACvD,CAAC;IAEJ,KAAK,CAAC,eAAe,CAAC,OAA+B;QACnD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/application/context/decisions/search/SearchDecisionsController.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SearchDecisionsController - Application controller that handles
+ * search-decisions requests by delegating to ISearchDecisionsGateway.
+ */
+import { ISearchDecisionsGateway } from "./ISearchDecisionsGateway.js";
+import { SearchDecisionsRequest } from "./SearchDecisionsRequest.js";
+import { SearchDecisionsResponse } from "./SearchDecisionsResponse.js";
+export declare class SearchDecisionsController {
+    private readonly gateway;
+    constructor(gateway: ISearchDecisionsGateway);
+    handle(request: SearchDecisionsRequest): Promise<SearchDecisionsResponse>;
+}
+//# sourceMappingURL=SearchDecisionsController.d.ts.map

package/dist/application/context/decisions/search/SearchDecisionsController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsController.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsController.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAG7C,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAGhF"}

package/dist/application/context/decisions/search/SearchDecisionsController.js

@@ -0,0 +1,13 @@
+/**
+ * SearchDecisionsController - Application controller that handles
+ * search-decisions requests by delegating to ISearchDecisionsGateway.
+ */
+export class SearchDecisionsController {
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    async handle(request) {
+        return this.gateway.searchDecisions(request);
+    }
+}
+//# sourceMappingURL=SearchDecisionsController.js.map

package/dist/application/context/decisions/search/SearchDecisionsController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsController.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsController.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,OAAO,yBAAyB;IACpC,YACmB,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAChD,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,OAA+B;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/application/context/decisions/search/SearchDecisionsRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SearchDecisionsRequest - Request DTO for the search-decisions use case.
+ */
+import { DecisionSearchCriteria } from "./DecisionSearchCriteria.js";
+export interface SearchDecisionsRequest {
+    readonly criteria: DecisionSearchCriteria;
+}
+//# sourceMappingURL=SearchDecisionsRequest.d.ts.map

package/dist/application/context/decisions/search/SearchDecisionsRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsRequest.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsRequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;CAC3C"}

package/dist/application/context/decisions/search/SearchDecisionsRequest.js

@@ -0,0 +1,5 @@
+/**
+ * SearchDecisionsRequest - Request DTO for the search-decisions use case.
+ */
+export {};
+//# sourceMappingURL=SearchDecisionsRequest.js.map

package/dist/application/context/decisions/search/SearchDecisionsRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsRequest.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsRequest.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/application/context/decisions/search/SearchDecisionsResponse.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SearchDecisionsResponse - Response DTO for the search-decisions use case.
+ */
+import { DecisionView } from "../DecisionView.js";
+export interface SearchDecisionsResponse {
+    readonly decisions: DecisionView[];
+}
+//# sourceMappingURL=SearchDecisionsResponse.d.ts.map

package/dist/application/context/decisions/search/SearchDecisionsResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsResponse.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsResponse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC;CACpC"}

package/dist/application/context/decisions/search/SearchDecisionsResponse.js

@@ -0,0 +1,5 @@
+/**
+ * SearchDecisionsResponse - Response DTO for the search-decisions use case.
+ */
+export {};
+//# sourceMappingURL=SearchDecisionsResponse.js.map

package/dist/application/context/decisions/search/SearchDecisionsResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDecisionsResponse.js","sourceRoot":"","sources":["../../../../../src/application/context/decisions/search/SearchDecisionsResponse.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/application/context/dependencies/get/IDependencyViewReader.d.ts

@@ -3,6 +3,7 @@
  * Used by ListDependenciesQueryHandler to retrieve dependency list with filtering.
  */
 import { DependencyView } from "../DependencyView.js";
+import { DependencySearchCriteria } from "../search/DependencySearchCriteria.js";
 export interface DependencyListFilter {
     name?: string;
     ecosystem?: string;
@@ -24,5 +25,11 @@ export interface IDependencyViewReader {
      * @returns Array of dependency views ordered by creation date (newest first)
      */
     findByIds(ids: string[]): Promise<DependencyView[]>;
+    /**
+     * Searches dependencies by criteria with AND logic.
+     * @param criteria - Search filters for identity fields, status, legacy links, and free text
+     * @returns Array of matching dependency views ordered by creation date (newest first)
+     */
+    search(criteria: DependencySearchCriteria): Promise<DependencyView[]>;
 }
 //# sourceMappingURL=IDependencyViewReader.d.ts.map

package/dist/application/context/dependencies/get/IDependencyViewReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IDependencyViewReader.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/dependencies/get/IDependencyViewReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAElE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACrD"}
+{"version":3,"file":"IDependencyViewReader.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/dependencies/get/IDependencyViewReader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAElE;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEpD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE"}

package/dist/application/context/dependencies/search/DependencySearchCriteria.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DependencySearchCriteria - Search filter for querying dependency memories.
+ *
+ * All fields are optional. When multiple fields are specified,
+ * they are combined with AND logic.
+ *
+ * Identity fields use substring matching by default and support * wildcards.
+ * Status uses exact matching.
+ * Query searches across identity and descriptive dependency fields.
+ */
+import { DependencyStatusType } from "../../../../domain/dependencies/Constants.js";
+export interface DependencySearchCriteria {
+    readonly name?: string;
+    readonly ecosystem?: string;
+    readonly packageName?: string;
+    readonly versionConstraint?: string;
+    readonly status?: DependencyStatusType;
+    readonly consumer?: string;
+    readonly provider?: string;
+    readonly query?: string;
+}
+//# sourceMappingURL=DependencySearchCriteria.d.ts.map

package/dist/application/context/dependencies/search/DependencySearchCriteria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencySearchCriteria.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/dependencies/search/DependencySearchCriteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/application/context/dependencies/search/DependencySearchCriteria.js

@@ -0,0 +1,12 @@
+/**
+ * DependencySearchCriteria - Search filter for querying dependency memories.
+ *
+ * All fields are optional. When multiple fields are specified,
+ * they are combined with AND logic.
+ *
+ * Identity fields use substring matching by default and support * wildcards.
+ * Status uses exact matching.
+ * Query searches across identity and descriptive dependency fields.
+ */
+export {};
+//# sourceMappingURL=DependencySearchCriteria.js.map

package/dist/application/context/dependencies/search/DependencySearchCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencySearchCriteria.js","sourceRoot":"","sources":["../../../../../src/application/context/dependencies/search/DependencySearchCriteria.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/application/context/dependencies/search/ISearchDependenciesGateway.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ISearchDependenciesGateway - Application-layer gateway interface
+ * defining the contract for searching dependencies.
+ */
+import { SearchDependenciesRequest } from "./SearchDependenciesRequest.js";
+import { SearchDependenciesResponse } from "./SearchDependenciesResponse.js";
+export interface ISearchDependenciesGateway {
+    searchDependencies(request: SearchDependenciesRequest): Promise<SearchDependenciesResponse>;
+}
+//# sourceMappingURL=ISearchDependenciesGateway.d.ts.map

package/dist/application/context/dependencies/search/ISearchDependenciesGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISearchDependenciesGateway.d.ts","sourceRoot":"","sources":["../../../../../src/application/context/dependencies/search/ISearchDependenciesGateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC7F"}

package/dist/application/context/dependencies/search/ISearchDependenciesGateway.js

@@ -0,0 +1,6 @@
+/**
+ * ISearchDependenciesGateway - Application-layer gateway interface
+ * defining the contract for searching dependencies.
+ */
+export {};
+//# sourceMappingURL=ISearchDependenciesGateway.js.map