@cleocode/core 2026.3.42 → 2026.3.44

package/dist/skills/injection/subagent.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Subagent protocol injection.
+ * Ports lib/skills/subagent-inject.sh.
+ *
+ * Guarantees protocol compliance for all subagent spawns by automatically
+ * injecting the RFC 2119 protocol base from skills/_shared/subagent-protocol-base.md.
+ *
+ * Injection pattern:
+ *   [SKILL CONTENT]
+ *   ---
+ *   ## SUBAGENT PROTOCOL (RFC 2119)
+ *   [Content from subagent-protocol-base.md with tokens resolved]
+ *   ---
+ *   [TASK CONTEXT]
+ *
+ * @epic T4454
+ * @task T4521
+ */
+import { type TokenValues } from './token.js';
+/**
+ * Load the subagent protocol base content.
+ * @task T4521
+ */
+export declare function loadProtocolBase(cwd?: string): string | null;
+/**
+ * Build task context block for injection into a subagent prompt.
+ * @task T4521
+ */
+export declare function buildTaskContext(taskId: string, cwd?: string): Promise<string>;
+/**
+ * Filter protocol content by MVI tier.
+ * Extracts sections based on <!-- TIER:X --> markers.
+ * - tier 0: header + minimal only + footer
+ * - tier 1: header + minimal + standard + footer
+ * - tier 2: header + all tiers + footer (full content)
+ *
+ * Header = content before first TIER marker.
+ * Footer = content after last /TIER marker.
+ *
+ * @task T5155
+ */
+export declare function filterProtocolByTier(content: string, tier: 0 | 1 | 2): string;
+/**
+ * Inject the subagent protocol into skill content.
+ * Composes: skill content + protocol base + task context.
+ * @task T4521
+ */
+export declare function injectProtocol(skillContent: string, taskId: string, tokenValues: TokenValues, cwd?: string, tier?: 0 | 1 | 2): Promise<string>;
+/**
+ * Full orchestrator spawn workflow (skill-based).
+ * High-level function that loads the skill, injects protocol, and returns the prompt.
+ * @task T4521
+ */
+export declare function orchestratorSpawnSkill(taskId: string, skillName: string, tokenValues: TokenValues, cwd?: string, tier?: 0 | 1 | 2): Promise<string>;
+/**
+ * Prepare standard token values for a task spawn.
+ * @task T4521
+ */
+export declare function prepareTokenValues(taskId: string, topicSlug: string, epicId?: string, _cwd?: string): TokenValues;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/skills/injection/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/skills/injection/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAa5D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAMD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCpF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CA0C7E;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,EACxB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,WAAW,EACxB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,WAAW,CAgBb"}

package/dist/skills/injection/token.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Token injection library for subagent templates.
+ * Ports lib/skills/token-inject.sh.
+ *
+ * Implements strict token replacement with validation to prevent hallucination.
+ * All tokens use {{TOKEN_NAME}} format.
+ *
+ * @epic T4454
+ * @task T4521
+ */
+/** Token values map: TOKEN_NAME -> value. */
+export type TokenValues = Record<string, string>;
+/** Token definition from placeholders.json. */
+interface PlaceholderDef {
+    token: string;
+    description?: string;
+    pattern?: string;
+    default?: string;
+}
+/** Placeholders.json schema. */
+interface PlaceholdersConfig {
+    required?: PlaceholderDef[];
+    context?: PlaceholderDef[];
+    taskCommands?: {
+        tokens: PlaceholderDef[];
+    };
+    taskContext?: {
+        tokens: PlaceholderDef[];
+    };
+    skillSpecific?: {
+        tokens: PlaceholderDef[];
+    };
+}
+/**
+ * Load token definitions from placeholders.json.
+ * @task T4521
+ */
+export declare function loadPlaceholders(cwd?: string): PlaceholdersConfig | null;
+/**
+ * Build the full default values map (merging placeholders.json with hardcoded defaults).
+ * @task T4521
+ */
+export declare function buildDefaults(cwd?: string): TokenValues;
+/**
+ * Validate a single token value against its pattern.
+ * @task T4521
+ */
+export declare function validateTokenValue(token: string, value: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Validate all required tokens are present and valid.
+ * @task T4521
+ */
+export declare function validateRequired(values: TokenValues): {
+    valid: boolean;
+    missing: string[];
+    invalid: Array<{
+        token: string;
+        error: string;
+    }>;
+};
+/**
+ * Validate all tokens in a values map (required + optional).
+ * @task T4521
+ */
+export declare function validateAllTokens(values: TokenValues): {
+    valid: boolean;
+    errors: Array<{
+        token: string;
+        error: string;
+    }>;
+};
+/**
+ * Inject token values into a template string.
+ * Replaces all {{TOKEN_NAME}} patterns with corresponding values.
+ * Unresolved tokens are left as-is (for debugging).
+ * @task T4521
+ */
+export declare function injectTokens(template: string, values: TokenValues): string;
+/**
+ * Check if a template has unresolved tokens after injection.
+ * @task T4521
+ */
+export declare function hasUnresolvedTokens(content: string): string[];
+/**
+ * Load a skill template and inject tokens.
+ * @task T4521
+ */
+export declare function loadAndInject(templatePath: string, values: TokenValues): {
+    content: string;
+    unresolvedTokens: string[];
+};
+/**
+ * Build a complete TokenValues map from a task, resolving all standard tokens.
+ * Ports ti_set_full_context from lib/skills/token-inject.sh.
+ *
+ * This is the primary entry point for orchestrators to prepare token values
+ * before spawning subagents. It populates: TASK_ID, DATE, TOPIC_SLUG, EPIC_ID,
+ * TITLE, TASK_TITLE, TASK_DESCRIPTION, TOPICS_JSON, DEPENDS_LIST, RESEARCH_ID,
+ * OUTPUT_DIR, MANIFEST_PATH, and all command defaults.
+ *
+ * @task T4712
+ * @epic T4663
+ */
+export declare function setFullContext(task: {
+    id: string;
+    title: string;
+    description?: string;
+    parentId?: string;
+    labels?: string[];
+    depends?: string[];
+}, options?: {
+    date?: string;
+    topicSlug?: string;
+    outputDir?: string;
+    manifestPath?: string;
+}): TokenValues;
+export {};
+//# sourceMappingURL=token.d.ts.map

package/dist/skills/injection/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/skills/injection/token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD,+CAA+C;AAC/C,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gCAAgC;AAChC,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAC5C,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAC3C,aAAa,CAAC,EAAE;QAAE,MAAM,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;CAC9C;AAoDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAWxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAwBvD;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBpC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD,CAsBA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG;IACtD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD,CAYA;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAY1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAG7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAUjD;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,EACD,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,WAAW,CA+Cb"}

package/dist/skills/install.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Skills installation functions.
+ * Delegates installation to CAAMP.
+ *
+ * @epic T4454
+ * @task T4521
+ */
+/**
+ * Install a single skill via CAAMP.
+ */
+export declare function installSkill(skillName: string, projectDir?: string): Promise<{
+    installed: boolean;
+    path: string;
+    error?: string;
+}>;
+//# sourceMappingURL=install.d.ts.map

package/dist/skills/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/skills/install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B/D"}

package/dist/skills/manifests/contribution.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Multi-agent contribution protocol.
+ * Ports lib/skills/contribution-protocol.sh.
+ *
+ * Implements the contribution protocol for multi-agent research coordination:
+ * template instantiation, task validation, injection block generation,
+ * conflict detection, and consensus computation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import type { ManifestEntry } from '../types.js';
+/** A contribution decision from an agent. */
+export interface ContributionDecision {
+    agentId: string;
+    taskId: string;
+    decision: string;
+    confidence: number;
+    rationale: string;
+}
+/** Conflict between two agent decisions. */
+export interface ContributionConflict {
+    field: string;
+    agent1: string;
+    agent2: string;
+    value1: string;
+    value2: string;
+    severity: 'low' | 'medium' | 'high';
+}
+/** Consensus result from weighted voting. */
+export interface ConsensusResult {
+    decision: string;
+    confidence: number;
+    votes: Array<{
+        agentId: string;
+        weight: number;
+        vote: string;
+    }>;
+    conflicts: ContributionConflict[];
+}
+/**
+ * Generate a unique contribution ID.
+ * @task T4520
+ */
+export declare function generateContributionId(taskId: string): string;
+/**
+ * Validate that a task is suitable for contribution protocol.
+ * @task T4520
+ */
+export declare function validateContributionTask(taskId: string, cwd?: string): Promise<{
+    valid: boolean;
+    issues: string[];
+}>;
+/**
+ * Generate the contribution injection block for a subagent prompt.
+ * @task T4520
+ */
+export declare function getContributionInjection(taskId: string, protocolPath?: string, _cwd?: string): string;
+/**
+ * Detect conflicts between two sets of decisions.
+ * @task T4520
+ */
+export declare function detectConflicts(decisions1: ContributionDecision[], decisions2: ContributionDecision[]): ContributionConflict[];
+/**
+ * Compute weighted consensus from multiple agent decisions.
+ * @task T4520
+ */
+export declare function computeConsensus(decisions: ContributionDecision[], weights?: Record<string, number>): ConsensusResult;
+/**
+ * Create a manifest entry for a contribution.
+ * @task T4520
+ */
+export declare function createContributionManifestEntry(taskId: string, contributionId: string, decisions: ContributionDecision[]): ManifestEntry;
+//# sourceMappingURL=contribution.d.ts.map

package/dist/skills/manifests/contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../../src/skills/manifests/contribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoB/C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAyBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,oBAAoB,EAAE,EAClC,UAAU,EAAE,oBAAoB,EAAE,GACjC,oBAAoB,EAAE,CAuBxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,oBAAoB,EAAE,EACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,eAAe,CAyDjB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,oBAAoB,EAAE,GAChC,aAAa,CAcf"}

package/dist/skills/manifests/research.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Research manifest CRUD operations.
+ * Ports lib/skills/research-manifest.sh.
+ *
+ * Manages MANIFEST.jsonl (append-only JSONL format) for agent outputs.
+ * Supports read, append, find, filter, archive, and rotation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import type { ManifestEntry } from '../types.js';
+/**
+ * Ensure agent outputs directory and manifest file exist.
+ * @task T4520
+ */
+export declare function ensureOutputs(cwd?: string): {
+    created: string[];
+};
+/**
+ * Read all manifest entries.
+ * @task T4520
+ */
+export declare function readManifest(cwd?: string): ManifestEntry[];
+/**
+ * Append a manifest entry (atomic JSONL append).
+ * @task T4520
+ */
+export declare function appendManifest(entry: ManifestEntry, cwd?: string): void;
+/**
+ * Find a manifest entry by ID.
+ * @task T4520
+ */
+export declare function findEntry(id: string, cwd?: string): ManifestEntry | null;
+/**
+ * Filter manifest entries by criteria.
+ * @task T4520
+ */
+export declare function filterEntries(criteria: {
+    status?: string;
+    agentType?: string;
+    topic?: string;
+    linkedTask?: string;
+    actionable?: boolean;
+}, cwd?: string): ManifestEntry[];
+/**
+ * Get entries with pending follow-ups.
+ * @task T4520
+ */
+export declare function getPendingFollowup(cwd?: string): ManifestEntry[];
+/**
+ * Get unique follow-up task IDs from all manifest entries.
+ * @task T4520
+ */
+export declare function getFollowupTaskIds(cwd?: string): string[];
+/**
+ * Check if a task has linked research.
+ * @task T4520
+ */
+export declare function taskHasResearch(taskId: string, cwd?: string): {
+    hasResearch: boolean;
+    count: number;
+};
+/**
+ * Archive a manifest entry (move to archive status).
+ * @task T4520
+ */
+export declare function archiveEntry(entryId: string, cwd?: string): boolean;
+/**
+ * Rotate manifest by archiving old entries.
+ * @task T4520
+ */
+export declare function rotateManifest(maxEntries?: number, cwd?: string): number;
+//# sourceMappingURL=research.d.ts.map

package/dist/skills/manifests/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/skills/manifests/research.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuBjE;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAkB1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBvE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,EACD,GAAG,CAAC,EAAE,MAAM,GACX,aAAa,EAAE,CAwBjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAGhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAazD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAmCnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,GAAE,MAAY,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CA0B7E"}

package/dist/skills/manifests/resolver.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cached manifest generation and resolution.
+ * Ports lib/skills/manifest-resolver.sh.
+ *
+ * Generates and caches a unified skills manifest by scanning all search paths.
+ * Uses TTL-based cache with graceful degradation.
+ *
+ * @epic T4454
+ * @task T4520
+ */
+import type { SkillManifest } from '../types.js';
+/**
+ * Check if the cached manifest is fresh (within TTL).
+ * @task T4520
+ */
+export declare function isCacheFresh(cachePath?: string): boolean;
+/**
+ * Invalidate the cache (delete the cached manifest).
+ * @task T4520
+ */
+export declare function invalidateCache(): void;
+/**
+ * Resolve the skills manifest.
+ * Returns a cached version if fresh, otherwise generates a new one.
+ *
+ * Graceful degradation:
+ *   1. Fresh cached manifest (within TTL)
+ *   2. Stale cached manifest (expired but valid)
+ *   3. Embedded project manifest (skills/manifest.json)
+ *   4. Freshly generated manifest
+ *
+ * @task T4520
+ */
+export declare function resolveManifest(cwd?: string): SkillManifest;
+/**
+ * Force regenerate the cache.
+ * @task T4520
+ */
+export declare function regenerateCache(cwd?: string): SkillManifest;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/skills/manifests/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/skills/manifests/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA0BjD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAgBxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CA4C3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,aAAa,CAe3D"}

package/dist/skills/marketplace.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SkillsMP (Skills Marketplace) integration.
+ * Delegates to @cleocode/caamp MarketplaceClient for core marketplace operations.
+ *
+ * @epic T4454
+ * @task T4521
+ */
+/** SkillsMP configuration. */
+export interface SkillsMpConfig {
+    enabled: boolean;
+    cacheDir: string;
+}
+/** Marketplace skill result (CLEO-specific shape). */
+export interface MarketplaceSkill {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    tags: string[];
+    downloadUrl?: string;
+}
+/**
+ * Load SkillsMP configuration from skillsmp.json.
+ * @task T4521
+ */
+export declare function loadConfig(cwd?: string): SkillsMpConfig | null;
+/**
+ * Search the skills marketplace.
+ * Delegates to CAAMP's searchSkills for the actual API call.
+ * @task T4521
+ */
+export declare function searchSkills(query: string, _config?: SkillsMpConfig): Promise<MarketplaceSkill[]>;
+/**
+ * Get a specific skill from the marketplace.
+ * Uses CAAMP's MarketplaceClient for retrieval.
+ * @task T4521
+ */
+export declare function getSkill(skillId: string, _config?: SkillsMpConfig): Promise<MarketplaceSkill | null>;
+/**
+ * Check if the marketplace is enabled and reachable.
+ * @task T4521
+ */
+export declare function isEnabled(cwd?: string): boolean;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/skills/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/skills/marketplace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAiB9D;AAqBD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CASlC;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAG/C"}

package/dist/skills/orchestrator/spawn.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Orchestrator spawn logic.
+ * Ports lib/skills/orchestrator-spawn.sh (prompt building functions from orchestrator-startup.sh).
+ *
+ * Builds fully-resolved prompts for subagent spawning by:
+ *   1. Loading skill template (SKILL.md)
+ *   2. Injecting token values
+ *   3. Appending protocol base
+ *   4. Appending task context
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import type { Task } from '@cleocode/contracts';
+import type { SpawnPromptResult } from '../types.js';
+/**
+ * Build a fully-resolved prompt for spawning a subagent.
+ * @task T4519
+ */
+export declare function buildPrompt(taskId: string, templateName?: string, cwd?: string, tier?: 0 | 1 | 2): Promise<SpawnPromptResult>;
+/**
+ * Generate full spawn command with metadata.
+ * @task T4519
+ */
+export declare function spawn(taskId: string, templateName?: string, cwd?: string, tier?: 0 | 1 | 2): Promise<SpawnPromptResult & {
+    spawnTimestamp: string;
+}>;
+/**
+ * Check if tasks can be spawned in parallel (no inter-dependencies).
+ * @task T4519
+ */
+export declare function canParallelize(taskIds: string[], cwd?: string): Promise<{
+    canParallelize: boolean;
+    conflicts: Array<Pick<Task, 'id'> & {
+        dependsOn: string[];
+    }>;
+    safeToSpawn: string[];
+}>;
+/** Result of a single spawn within a batch. */
+export interface BatchSpawnEntry {
+    taskId: string;
+    success: boolean;
+    result?: SpawnPromptResult & {
+        spawnTimestamp: string;
+    };
+    error?: string;
+}
+/** Result of a batch spawn operation. */
+export interface BatchSpawnResult {
+    count: number;
+    succeeded: number;
+    failed: number;
+    spawns: BatchSpawnEntry[];
+}
+/**
+ * Spawn prompts for multiple tasks in a batch.
+ * Ports orchestrator_spawn_batch from lib/skills/orchestrator-spawn.sh.
+ *
+ * Iterates over task IDs, building spawn prompts for each. Individual failures
+ * are captured per-entry rather than aborting the entire batch.
+ *
+ * @task T4712
+ * @epic T4663
+ */
+export declare function spawnBatch(taskIds: string[], templateName?: string, cwd?: string, tier?: 0 | 1 | 2): Promise<BatchSpawnResult>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/skills/orchestrator/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAQhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMrD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAwB,EACtC,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,OAAO,CAAC,iBAAiB,CAAC,CAyF5B;AAED;;;GAGG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,GAAE,MAAwB,EACtC,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,OAAO,CAAC,iBAAiB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAOzD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IACT,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,CA6BD;AAMD,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,iBAAiB,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACf,OAAO,CAAC,gBAAgB,CAAC,CAmB3B"}

package/dist/skills/orchestrator/startup.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Orchestrator session startup protocol.
+ * Ports lib/skills/orchestrator-startup.sh.
+ *
+ * Implements the session startup sequence, context monitoring,
+ * dependency analysis, task spawning, and HITL summary generation.
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import type { Task, TaskRefPriority } from '@cleocode/contracts';
+import type { DependencyAnalysis, HitlSummary, OrchestratorThresholds } from '../types.js';
+/**
+ * Get orchestrator context thresholds from config or defaults.
+ * @task T4519
+ */
+export declare function getThresholds(config?: Record<string, unknown>): OrchestratorThresholds;
+interface ContextState {
+    percentage: number;
+    currentTokens: number;
+    maxTokens: number;
+    status: string;
+    stale: boolean;
+}
+/**
+ * Read the current context state from session-aware files.
+ * @task T4519
+ */
+export declare function getContextState(sessionId?: string, cwd?: string): ContextState;
+/** Session init result. */
+export interface SessionInitResult {
+    activeSessions: number;
+    activeSessionId: string | null;
+    activeScope: string | null;
+    hasFocus: boolean;
+    focusedTask: string | null;
+    hasPending: boolean;
+    recommendedAction: 'resume' | 'spawn_followup' | 'create_and_spawn' | 'request_direction';
+    actionReason: string;
+}
+/**
+ * Initialize orchestrator session state.
+ * Determines the recommended action based on current state.
+ * @task T4519
+ */
+export declare function sessionInit(epicId?: string, cwd?: string): Promise<SessionInitResult>;
+/** Pause status result. */
+export interface PauseStatus {
+    pauseStatus: 'ok' | 'warning' | 'critical';
+    pauseCode: 0 | 1 | 2;
+    shouldPause: boolean;
+    shouldWrapUp: boolean;
+    contextPercentage: number;
+    recommendation: string;
+}
+/**
+ * Check if orchestrator should pause based on context usage.
+ * @task T4519
+ */
+export declare function shouldPause(config?: Record<string, unknown>, sessionId?: string, cwd?: string): PauseStatus;
+/**
+ * Analyze dependency graph and compute execution waves.
+ * @task T4519
+ */
+export declare function analyzeDependencies(epicId: string, cwd?: string): Promise<DependencyAnalysis>;
+/**
+ * Get the next task ready to spawn for an epic.
+ * @task T4519
+ */
+export declare function getNextTask(epicId: string, cwd?: string): Promise<{
+    task: Task | null;
+    readyCount: number;
+}>;
+/**
+ * Get all tasks ready to spawn in parallel (no inter-dependencies).
+ * @task T4519
+ */
+export declare function getReadyTasks(epicId: string, cwd?: string): Promise<TaskRefPriority[]>;
+/**
+ * Generate a Human-in-the-Loop summary for session handoff.
+ * @task T4519
+ */
+export declare function generateHitlSummary(epicId?: string, stopReason?: string, cwd?: string): Promise<HitlSummary>;
+export {};
+//# sourceMappingURL=startup.d.ts.map

package/dist/skills/orchestrator/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/startup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAW,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAGzF,OAAO,KAAK,EACV,kBAAkB,EAElB,WAAW,EACX,sBAAsB,EACvB,MAAM,aAAa,CAAC;AASrB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB,CAYtF;AAMD,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,YAAY,CAkD9E;AAMD,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IAC1F,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyF3F;AAMD,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,WAAW,CAkCb;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAmG7B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAapD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAiB5F;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,GAAE,MAAwB,EACpC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CA+FtB"}

package/dist/skills/orchestrator/validator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Orchestrator protocol compliance validation.
+ * Ports lib/skills/orchestrator-validator.sh.
+ *
+ * Validates subagent output compliance, orchestrator behavior,
+ * manifest integrity, and pre-spawn compliance checks.
+ *
+ * @epic T4454
+ * @task T4519
+ */
+import type { ComplianceResult, ManifestValidationResult } from '../types.js';
+/**
+ * Validate a subagent's manifest entry for protocol compliance.
+ * @task T4519
+ */
+export declare function validateSubagentOutput(researchId: string, cwd?: string): {
+    passed: boolean;
+    issues: string[];
+    checkedRules: string[];
+};
+/**
+ * Validate the entire manifest file integrity.
+ * @task T4519
+ */
+export declare function validateManifestIntegrity(cwd?: string): ManifestValidationResult;
+/**
+ * Verify previous agent completed protocol compliance before spawning next.
+ * @task T4519
+ */
+export declare function verifyCompliance(previousTaskId: string, researchId?: string, cwd?: string): ComplianceResult;
+/**
+ * Validate orchestrator compliance (post-hoc behavioral checks).
+ * @task T4519
+ */
+export declare function validateOrchestratorCompliance(epicId?: string, cwd?: string): Promise<{
+    compliant: boolean;
+    violations: string[];
+    warnings: string[];
+}>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/skills/orchestrator/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/skills/orchestrator/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAwD7F;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAwE/D;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAkEhF;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,gBAAgB,CA6DlB;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,CAAC,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAkDD"}