cognitive-core 0.0.2 → 0.1.2

package/dist/types/task.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+/**
+ * Verification specification for validating task outcomes
+ */
+export declare const VerificationSpecSchema: z.ZodObject<{
+    type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+    expected: z.ZodOptional<z.ZodUnknown>;
+    tolerance: z.ZodOptional<z.ZodNumber>;
+    verifier_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "function" | "exact_match" | "fuzzy_match" | "llm";
+    expected?: unknown;
+    tolerance?: number | undefined;
+    verifier_id?: string | undefined;
+}, {
+    type: "function" | "exact_match" | "fuzzy_match" | "llm";
+    expected?: unknown;
+    tolerance?: number | undefined;
+    verifier_id?: string | undefined;
+}>;
+export type VerificationSpec = z.infer<typeof VerificationSpecSchema>;
+/**
+ * Task - The fundamental unit of work
+ * Represents what an agent needs to accomplish
+ */
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    domain: z.ZodString;
+    description: z.ZodString;
+    context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    verification: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+        expected: z.ZodOptional<z.ZodUnknown>;
+        tolerance: z.ZodOptional<z.ZodNumber>;
+        verifier_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    }, {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    }>>;
+    embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodDefault<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    domain: string;
+    description: string;
+    context: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    verification?: {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    } | undefined;
+    embedding?: number[] | undefined;
+}, {
+    id: string;
+    domain: string;
+    description: string;
+    context?: Record<string, unknown> | undefined;
+    verification?: {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    } | undefined;
+    embedding?: number[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: Date | undefined;
+}>;
+export type Task = z.infer<typeof TaskSchema>;
+/**
+ * Create a new task with defaults
+ */
+export declare function createTask(params: {
+    id?: string;
+    domain: string;
+    description: string;
+    context?: Record<string, unknown>;
+    verification?: VerificationSpec;
+    metadata?: Record<string, unknown>;
+}): Task;
+//# sourceMappingURL=task.d.ts.map

package/dist/types/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,IAAI,CAUP"}

package/dist/types/task.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * Verification specification for validating task outcomes
+ */
+export const VerificationSpecSchema = z.object({
+    type: z.enum(['exact_match', 'fuzzy_match', 'function', 'llm']),
+    expected: z.unknown().optional(),
+    tolerance: z.number().optional(),
+    verifier_id: z.string().optional(),
+});
+/**
+ * Task - The fundamental unit of work
+ * Represents what an agent needs to accomplish
+ */
+export const TaskSchema = z.object({
+    id: z.string(),
+    domain: z.string(), // e.g., 'arc', 'swe', 'code', 'reasoning'
+    description: z.string(),
+    context: z.record(z.unknown()).default({}),
+    verification: VerificationSpecSchema.optional(),
+    embedding: z.array(z.number()).optional(),
+    metadata: z.record(z.unknown()).default({}),
+    createdAt: z.date().default(() => new Date()),
+});
+/**
+ * Create a new task with defaults
+ */
+export function createTask(params) {
+    return TaskSchema.parse({
+        id: params.id ?? crypto.randomUUID(),
+        domain: params.domain,
+        description: params.description,
+        context: params.context ?? {},
+        verification: params.verification,
+        metadata: params.metadata ?? {},
+        createdAt: new Date(),
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/D,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,0CAA0C;IAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,YAAY,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;CAC9C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAO1B;IACC,OAAO,UAAU,CAAC,KAAK,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/types/team-meta.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+/**
+ * TeamMetaObservation - Records team formation decisions and outcomes.
+ * The team-level analog of MetaObservation.
+ */
+export interface TeamMetaObservation {
+    id: string;
+    /** Source team trajectory */
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+    timestamp: Date;
+}
+/**
+ * How the team was formed and why.
+ */
+export interface FormationObservation {
+    /** Was a team playbook used to form this team? */
+    playbookUsed?: string;
+    /** Was the team formed from a template or ad-hoc? */
+    formationMethod: 'template' | 'playbook' | 'manual' | 'adaptive';
+    /** Confidence in the formation decision */
+    confidence: number;
+    /** Reasoning for formation choice */
+    reasoning: string;
+    /** Whether the formation was effective (DESIGN doc field) */
+    wasEffective?: boolean;
+    /** Topology type used (stored for reliable extraction in meta-learner) */
+    topologyUsed?: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Domain of the task */
+    domain?: string;
+}
+/**
+ * How effective was the team composition?
+ */
+export interface CompositionObservation {
+    /** Were all roles utilized? */
+    roleUtilization: Record<string, number>;
+    /** Were any roles missing that would have helped? */
+    missingRoles: string[];
+    /** Were any roles redundant? */
+    redundantRoles: string[];
+    /** Was team size appropriate? */
+    teamSizeAssessment: 'too-small' | 'right-sized' | 'too-large';
+    /** Was the topology appropriate? */
+    topologyAssessment: 'effective' | 'neutral' | 'hindering';
+}
+/**
+ * How effective was the coordination?
+ */
+export interface CoordinationObservation {
+    /** Was enforcement mode appropriate? */
+    enforcementAssessment: 'too-strict' | 'appropriate' | 'too-loose';
+    /** Were communication channels well-defined? */
+    channelEffectiveness: 'helpful' | 'neutral' | 'noisy';
+    /** Were there coordination bottlenecks? */
+    bottlenecks: string[];
+    /** Actual coordination overhead ratio */
+    coordinationOverhead: number;
+}
+/**
+ * Team outcome assessment.
+ */
+export interface TeamOutcomeObservation {
+    success: boolean;
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Was this faster than a single agent would have been? (estimated) */
+    speedupEstimate: number;
+    /** Cost efficiency: quality / tokens */
+    costEfficiency: number;
+}
+/**
+ * Lessons about team formation and coordination.
+ */
+export interface TeamLessonsLearned {
+    /** What team patterns worked */
+    whatWorked: string[];
+    /** What team patterns didn't work */
+    whatFailed: string[];
+    /** Suggestions for future team formation */
+    formationSuggestions: string[];
+    /** Suggestions for future coordination */
+    coordinationSuggestions: string[];
+    /** Role-specific suggestions (DESIGN doc field) */
+    roleSuggestions?: string[];
+}
+/**
+ * TeamMetaStrategy - Learned patterns about team formation.
+ * The team-level analog of MetaStrategy.
+ */
+export interface TeamMetaStrategy {
+    id: string;
+    name: string;
+    /** When to apply this team meta-strategy */
+    condition: TeamMetaCondition;
+    /** What formation/coordination adjustments to make */
+    adjustment: TeamMetaAdjustment;
+    /** Track effectiveness */
+    applicationCount: number;
+    successRate: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Conditions for applying a team meta-strategy.
+ */
+export interface TeamMetaCondition {
+    /** Task characteristics that trigger this strategy */
+    taskCharacteristics: string[];
+    /** Available resources */
+    resourceConstraints: string[];
+    /** Domain context */
+    domains: string[];
+}
+/**
+ * Adjustments to team formation and coordination.
+ */
+export interface TeamMetaAdjustment {
+    /** Topology recommendation */
+    topologyBias?: Record<string, number>;
+    /** Team size adjustment */
+    teamSizeAdjustment: 'increase' | 'decrease' | 'maintain';
+    /** Role adjustments */
+    roleAdjustments: string[];
+    /** Coordination hints */
+    coordinationHints: string[];
+    /** Enforcement mode recommendation */
+    enforcementBias?: 'strict' | 'permissive' | 'audit';
+}
+/**
+ * Create a new team meta-observation.
+ */
+export declare function createTeamMetaObservation(params: {
+    id?: string;
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+}): TeamMetaObservation;
+/**
+ * Create a new team meta-strategy.
+ */
+export declare function createTeamMetaStrategy(params: {
+    id?: string;
+    name: string;
+    condition: TeamMetaCondition;
+    adjustment: TeamMetaAdjustment;
+}): TeamMetaStrategy;
+//# sourceMappingURL=team-meta.d.ts.map

package/dist/types/team-meta.d.ts.map

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

package/dist/types/team-meta.js

@@ -0,0 +1,42 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+// ============================================================
+// Factory functions
+// ============================================================
+/**
+ * Create a new team meta-observation.
+ */
+export function createTeamMetaObservation(params) {
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        teamTrajectoryId: params.teamTrajectoryId,
+        formation: params.formation,
+        compositionEffectiveness: params.compositionEffectiveness,
+        coordinationEffectiveness: params.coordinationEffectiveness,
+        outcome: params.outcome,
+        lessons: params.lessons,
+        timestamp: new Date(),
+    };
+}
+/**
+ * Create a new team meta-strategy.
+ */
+export function createTeamMetaStrategy(params) {
+    const now = new Date();
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        name: params.name,
+        condition: params.condition,
+        adjustment: params.adjustment,
+        applicationCount: 0,
+        successRate: 0,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=team-meta.js.map

package/dist/types/team-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-meta.js","sourceRoot":"","sources":["../../src/types/team-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6JH,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAQzC;IACC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;QACzD,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;QAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAKtC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}

package/dist/types/team-playbook.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Team Playbook Types
+ *
+ * TeamPlaybook - Learned coordination patterns extracted from successful
+ * team trajectories. The team-level analog of Playbook.
+ *
+ * RolePlaybook - How to be effective in a specific team role.
+ * Distinct from individual task playbooks (about solving problems alone)
+ * and team coordination playbooks (about team composition).
+ */
+/**
+ * TeamPlaybook - Learned coordination pattern.
+ * Answers: "Given this type of task, how should a team be organized and coordinated?"
+ */
+export interface TeamPlaybook {
+    id: string;
+    name: string;
+    applicability: TeamPlaybookApplicability;
+    composition: TeamCompositionGuidance;
+    coordination: TeamCoordinationGuidance;
+    verification: TeamPlaybookVerification;
+    evolution: TeamPlaybookEvolution;
+    confidence: number;
+    complexity: 'simple' | 'moderate' | 'complex' | 'epic';
+    createdAt: Date;
+    updatedAt: Date;
+    /** Links to individual playbooks suggested for each role */
+    rolePlaybookReferences?: RolePlaybookReference[];
+}
+/**
+ * When to use this team pattern.
+ */
+export interface TeamPlaybookApplicability {
+    /** Task types this pattern works for */
+    taskTypes: string[];
+    /** Scale indicators */
+    teamSizeRange: {
+        min: number;
+        max: number;
+    };
+    /** Complexity levels this pattern handles */
+    complexityLevels: Array<'simple' | 'moderate' | 'complex' | 'epic'>;
+    /** Domains where this pattern has been proven */
+    domains: string[];
+    /** When NOT to use this pattern */
+    antiPatterns: string[];
+}
+/**
+ * How to compose the team.
+ */
+export interface TeamCompositionGuidance {
+    /** Recommended topology */
+    topology: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Role specifications */
+    roles: TeamRoleSpec[];
+    /** Spawn rules: which roles can spawn which */
+    spawnRules: Record<string, string[]>;
+    /** Recommended enforcement mode */
+    enforcement: 'strict' | 'permissive' | 'audit';
+}
+/**
+ * Specification for a role within the team pattern.
+ */
+export interface TeamRoleSpec {
+    /** Role name */
+    role: string;
+    /** Why this role is needed */
+    rationale: string;
+    /** Required capabilities */
+    capabilities: string[];
+    /** Whether this role is essential or optional */
+    optional: boolean;
+    /** Recommended model tier */
+    modelTier?: 'fast' | 'balanced' | 'capable';
+    /** Recommended spawn position */
+    spawnAs: 'root' | 'companion' | 'on-demand';
+}
+/**
+ * How team members should coordinate.
+ */
+export interface TeamCoordinationGuidance {
+    /** Execution model */
+    executionModel: 'sequential' | 'wave-parallel' | 'fully-parallel' | 'pipeline';
+    /** Communication channels to establish */
+    channels: TeamChannelSpec[];
+    /** Key interaction patterns */
+    interactionPatterns: InteractionPattern[];
+    /** Task delegation strategy */
+    delegationStrategy: string;
+    /** Checkpoint protocol */
+    checkpoints?: string[];
+}
+/**
+ * Specification for a communication channel.
+ */
+export interface TeamChannelSpec {
+    name: string;
+    signals: string[];
+    subscribers: string[];
+    emitters: string[];
+}
+/**
+ * A learned interaction pattern between roles.
+ */
+export interface InteractionPattern {
+    /** Short name */
+    name: string;
+    /** Description of when/how this pattern occurs */
+    description: string;
+    /** Roles involved */
+    roles: string[];
+    /** Frequency: how often this pattern should occur */
+    frequency: 'once' | 'per-task' | 'continuous';
+    /** Whether this pattern was correlated with success */
+    correlatedWithSuccess: boolean;
+}
+/**
+ * How to verify the team pattern worked.
+ */
+export interface TeamPlaybookVerification {
+    /** Metrics that indicate success */
+    successIndicators: string[];
+    /** Metrics that indicate failure */
+    failureIndicators: string[];
+    /** How to restructure if the pattern isn't working */
+    restructuringStrategy?: string;
+}
+/**
+ * Evolution tracking for team playbooks.
+ */
+export interface TeamPlaybookEvolution {
+    version: string;
+    /** Source team trajectory IDs */
+    createdFrom: string[];
+    /** Refinements from experience */
+    refinements: TeamRefinement[];
+    successCount: number;
+    failureCount: number;
+    lastUsed?: Date;
+    /** Average metrics across successful uses */
+    avgMetrics?: {
+        coordinationOverhead: number;
+        parallelismRatio: number;
+        timeToFirstOutput: number;
+    };
+}
+/**
+ * Context-specific refinement to team coordination.
+ */
+export interface TeamRefinement {
+    context: string;
+    adjustment: string;
+    source: 'failure' | 'success' | 'manual';
+    addedAt: Date;
+}
+/**
+ * Cross-reference from team playbook to individual playbooks for a role.
+ */
+export interface RolePlaybookReference {
+    role: string;
+    suggestedPlaybookIds: string[];
+}
+/**
+ * RolePlaybook - How to be effective in a specific team role.
+ * Captures teamwork behavior from a single agent's perspective.
+ */
+export interface RolePlaybook {
+    id: string;
+    name: string;
+    /** Which role this applies to */
+    role: string;
+    /** Team contexts where this guidance is relevant */
+    teamContext: RoleTeamContext;
+    guidance: RoleGuidance;
+    evolution: RolePlaybookEvolution;
+    confidence: number;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Cross-references to individual task playbooks effective for this role */
+    relatedTaskPlaybooks?: RelatedTaskPlaybook[];
+}
+/**
+ * Team context where a role playbook applies.
+ */
+export interface RoleTeamContext {
+    topologies: Array<'hierarchical' | 'flat' | 'wave' | 'custom'>;
+    teamSizeRange: {
+        min: number;
+        max: number;
+    };
+    taskTypes: string[];
+    domains: string[];
+}
+/**
+ * Guidance for a specific role.
+ */
+export interface RoleGuidance {
+    /** Core responsibilities when playing this role */
+    responsibilities: string[];
+    /** How to interact with each other role */
+    interactionGuidance: RoleInteractionGuidance[];
+    /** Decision frameworks specific to this role */
+    decisionFrameworks: RoleDecisionFramework[];
+    /** Common mistakes in this role */
+    antiPatterns: string[];
+}
+/**
+ * How to interact with a specific other role.
+ */
+export interface RoleInteractionGuidance {
+    /** Which other role */
+    withRole: string;
+    /** What type of interaction */
+    interactionType: string;
+    /** How to do it effectively */
+    guidance: string;
+    /** Concrete examples from successful executions */
+    examples: string[];
+    /** What NOT to do */
+    antiPatterns: string[];
+}
+/**
+ * Decision framework for a specific role context.
+ */
+export interface RoleDecisionFramework {
+    name: string;
+    when: string;
+    guidance: string;
+}
+/**
+ * Evolution tracking for role playbooks.
+ */
+export interface RolePlaybookEvolution {
+    version: string;
+    createdFrom: string[];
+    refinements: TeamRefinement[];
+    successCount: number;
+    failureCount: number;
+    lastUsed?: Date;
+}
+/**
+ * Cross-reference from role playbook to individual task playbooks.
+ */
+export interface RelatedTaskPlaybook {
+    playbookId: string;
+    playbookName: string;
+    applicableToTask: string;
+    rationale: string;
+}
+/**
+ * Create a new team playbook with defaults.
+ */
+export declare function createTeamPlaybook(input: Partial<TeamPlaybook> & {
+    name: string;
+    applicability: TeamPlaybookApplicability;
+    composition: TeamCompositionGuidance;
+    coordination: TeamCoordinationGuidance;
+}): TeamPlaybook;
+/**
+ * Create a new role playbook with defaults.
+ */
+export declare function createRolePlaybook(input: Partial<RolePlaybook> & {
+    name: string;
+    role: string;
+    teamContext: RoleTeamContext;
+    guidance: RoleGuidance;
+}): RolePlaybook;
+/**
+ * Get team playbook success rate.
+ */
+export declare function getTeamPlaybookSuccessRate(playbook: TeamPlaybook): number;
+/**
+ * Get role playbook success rate.
+ */
+export declare function getRolePlaybookSuccessRate(playbook: RolePlaybook): number;
+//# sourceMappingURL=team-playbook.d.ts.map

package/dist/types/team-playbook.d.ts.map

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