crewly 1.12.1 → 1.13.1

package/dist/cli/backend/src/services/ai/prompt-modules/lazy-anti-patterns.module.js

@@ -0,0 +1,79 @@
+/**
+ * Lazy Behavior Anti-Patterns block.
+ *
+ * P1 Fix 8 — Per spec
+ * `.crewly/specs/2026-05-03-agent-improvement-plan.md` §"Fix 8 — Lazy Behavior
+ * Anti-Patterns enumeration", this module emits the canonical seven-bullet
+ * enumeration of lazy behavior anti-patterns that an agent must self-check
+ * against, and that a reviewer must catch in PR review.
+ *
+ * Why a module (not just per-role markdown)?
+ * - The contract text must be byte-identical across every agent — a module
+ *   guarantees uniformity instead of relying on 20 role prompts staying in
+ *   sync over time as the team evolves the wording.
+ * - The text is small (~12 lines) and execution-defining ("you are failing
+ *   the task if you ..."), so it cannot be truncated under budget pressure
+ *   → `compactable = false` (Trusted Zone).
+ * - Sits at priority 3.7 — at the trailing edge of the authority cluster,
+ *   immediately after RequestContract (3.6), immediately before MemoryReference
+ *   (priority 4). The full authority cluster reads: identity → soul → recovery
+ *   → role-boundary → decision-rights → request-contract → lazy-anti-patterns
+ *   → memory-reference. The agent finishes authority context with "here is
+ *   what counts as failure" right before data context begins.
+ *
+ * Static role prompts under `config/roles/{role}/prompt.md` ALSO contain the
+ * same headers verbatim — this is intentional belt-and-suspenders coverage
+ * for the legacy `prompt-builder.service.ts` load path which does not run
+ * through `PromptAssemblyService`. Both runtimes carry the contract.
+ *
+ * Net-zero offset: vague platitude lines ("Be professional and customer-
+ * focused", "Be patient, empathetic, and solution-oriented", "Focus on user
+ * experience and accessibility", "Focus on user value and business impact",
+ * "Be thorough and detail-oriented", etc.) have been deleted from role
+ * prompts because the seven anti-patterns are concretely actionable and
+ * grep-able where those platitudes were not.
+ */
+export class LazyAntiPatternsModule {
+    name = 'lazy-anti-patterns';
+    priority = 3.7;
+    maxTokens = 200;
+    compactable = false;
+    /**
+     * Always include — the seven anti-patterns are universal worker + TL +
+     * orchestrator failure modes. The block is identical across roles
+     * because the meta-rule is universal; role-specific delegation /
+     * planning surfaces are already encoded in role-boundary text.
+     *
+     * @param _config - Unused; the inclusion rule is universal
+     * @returns Always true
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the Lazy Behavior Anti-Patterns section.
+     *
+     * Output is byte-identical regardless of role — see the class JSDoc for
+     * why universality is intentional. The seven bullets are verbatim from
+     * `.crewly/specs/2026-05-03-agent-improvement-plan.md` lines 386-401.
+     *
+     * @param _config - Module configuration (unused; content is static)
+     * @returns Formatted markdown block with one H2 section:
+     *   `## Lazy Behavior Anti-Patterns`
+     */
+    async build(_config) {
+        return [
+            '## Lazy Behavior Anti-Patterns',
+            '',
+            'You are failing the task if you:',
+            '- Ask the human for an implementation detail you could decide yourself.',
+            '- Report a plan without executing when execution is possible.',
+            '- Schedule follow-up instead of continuing work in-session.',
+            '- Mark blocked without trying at least one reasonable path.',
+            '- Stop after partial progress without assigning next action.',
+            '- Delegate without checking completion.',
+            '- Produce status updates but no artifact, code, decision, or verified result.',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=lazy-anti-patterns.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/lazy-anti-patterns.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-anti-patterns.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/lazy-anti-patterns.module.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAO,sBAAsB;IAClC,IAAI,GAAG,oBAAoB,CAAC;IAC5B,QAAQ,GAAG,GAAG,CAAC;IACf,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IAEpB;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAChC,OAAO;YACN,gCAAgC;YAChC,EAAE;YACF,kCAAkC;YAClC,yEAAyE;YACzE,+DAA+D;YAC/D,6DAA6D;YAC7D,6DAA6D;YAC7D,8DAA8D;YAC9D,yCAAyC;YACzC,+EAA+E;SAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;CACD"}

package/dist/cli/backend/src/services/ai/prompt-modules/learning-reference.module.d.ts

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Learning reference module — tells the agent how to access and leverage past learnings.
+ *
+ * Provides instructions for using record-learning, recalling past experiences,
+ * and applying lessons learned from previous sessions.
+ *
+ * Sources: LearningAccumulationService, record-learning skill.
+ */
+export declare class LearningReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the learning reference section with instructions
+     * on how to record and recall past learnings.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown learning reference section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=learning-reference.module.d.ts.map

package/dist/cli/backend/src/services/ai/prompt-modules/learning-reference.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/learning-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC3D,IAAI,SAAyB;IAC7B,QAAQ,SAAM;IACd,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BlD"}

package/dist/cli/backend/src/services/ai/prompt-modules/learning-reference.module.js

@@ -0,0 +1,55 @@
+/**
+ * Learning reference module — tells the agent how to access and leverage past learnings.
+ *
+ * Provides instructions for using record-learning, recalling past experiences,
+ * and applying lessons learned from previous sessions.
+ *
+ * Sources: LearningAccumulationService, record-learning skill.
+ */
+export class LearningReferenceModule {
+    name = 'learning_references';
+    priority = 10;
+    maxTokens = 250;
+    compactable = true;
+    /**
+     * Always included — agents should know how to learn from experience.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the learning reference section with instructions
+     * on how to record and recall past learnings.
+     *
+     * @param config - Module configuration with agent skill paths
+     * @returns Formatted markdown learning reference section
+     */
+    async build(config) {
+        return `## Learning from Experience
+
+### Recording Learnings
+When you discover something worth remembering for future sessions, record it immediately:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/record-learning/execute.sh '{"agentId":"${config.sessionName}","agentRole":"${config.role}","projectPath":"${config.projectPath || ''}","learning":"<what you learned>"}'
+\`\`\`
+
+**When to record:**
+- After resolving a bug — capture the root cause and fix
+- After discovering a code pattern or convention
+- After a failed approach — capture what didn't work and why
+- After completing a task — capture key findings and gotchas
+- When you find something that contradicts your assumptions
+
+### Recalling Learnings
+Before starting a task, check what you or other agents have learned:
+\`\`\`bash
+bash ${config.agentSkillsPath}/core/recall/execute.sh '{"agentId":"${config.sessionName}","context":"learnings about <topic>","projectPath":"${config.projectPath || ''}"}'
+\`\`\`
+
+### Applying Learnings
+- Check for relevant learnings before repeating an approach that may have failed before
+- Cross-reference learnings from other agents working on the same project
+- Update or correct stale learnings when you discover they no longer apply`;
+    }
+}
+//# sourceMappingURL=learning-reference.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/learning-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/learning-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IACnC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,QAAQ,GAAG,EAAE,CAAC;IACd,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,iDAAiD,MAAM,CAAC,WAAW,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;;;;;;;;OAalK,MAAM,CAAC,eAAe,wCAAwC,MAAM,CAAC,WAAW,wDAAwD,MAAM,CAAC,WAAW,IAAI,EAAE;;;;;;2EAM5F,CAAC;IAC3E,CAAC;CACD"}

package/dist/cli/backend/src/services/ai/prompt-modules/lifecycle.module.d.ts

@@ -0,0 +1,44 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Lifecycle module — agent lifecycle behaviors and cognitive loop.
+ *
+ * Consolidates proactive monitoring, auto progress heartbeat,
+ * work rhythm, session management, and the 4-stage cognitive
+ * lifecycle (Intent → Observation → Strategy → Adaptation).
+ *
+ * Orchestrator/TL agents get the full lifecycle spec including
+ * proactive monitoring and event subscription patterns.
+ * Workers get a compact work-rhythm-only version.
+ *
+ * Sources: orchestrator prompt.md §Proactive Monitoring,
+ *          §Auto Progress Heartbeat, §Session Management,
+ *          developer prompt.md §Work Rhythm.
+ */
+export declare class LifecycleModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — all agents need lifecycle guidance.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the lifecycle section.
+     * Orchestrators/TLs get the full spec; workers get a compact version.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown lifecycle section
+     */
+    build(config: ModuleConfig): Promise<string>;
+    /**
+     * Full lifecycle for orchestrators and team leaders —
+     * includes proactive monitoring, cognitive loop, heartbeat, and session management.
+     */
+    private buildFullLifecycle;
+    /**
+     * Compact lifecycle for workers — work rhythm and context management only.
+     */
+    private buildWorkerLifecycle;
+}
+//# sourceMappingURL=lifecycle.module.d.ts.map

package/dist/cli/backend/src/services/ai/prompt-modules/lifecycle.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/lifecycle.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACnD,IAAI,SAAe;IACnB,QAAQ,SAAM;IACd,SAAS,SAAO;IAChB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBlD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAwB5B"}

package/dist/cli/backend/src/services/ai/prompt-modules/lifecycle.module.js

@@ -0,0 +1,120 @@
+import { loadRoleFragment } from './prompt-module.interface.js';
+/**
+ * Lifecycle module — agent lifecycle behaviors and cognitive loop.
+ *
+ * Consolidates proactive monitoring, auto progress heartbeat,
+ * work rhythm, session management, and the 4-stage cognitive
+ * lifecycle (Intent → Observation → Strategy → Adaptation).
+ *
+ * Orchestrator/TL agents get the full lifecycle spec including
+ * proactive monitoring and event subscription patterns.
+ * Workers get a compact work-rhythm-only version.
+ *
+ * Sources: orchestrator prompt.md §Proactive Monitoring,
+ *          §Auto Progress Heartbeat, §Session Management,
+ *          developer prompt.md §Work Rhythm.
+ */
+export class LifecycleModule {
+    name = 'lifecycle';
+    priority = 11;
+    maxTokens = 800;
+    compactable = true;
+    /**
+     * Always included — all agents need lifecycle guidance.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the lifecycle section.
+     * Orchestrators/TLs get the full spec; workers get a compact version.
+     *
+     * @param config - Module configuration with agent details
+     * @returns Formatted markdown lifecycle section
+     */
+    async build(config) {
+        const isOrchestrator = config.role === 'orchestrator';
+        const isTL = config.canDelegate === true;
+        // Try loading role-specific fragment
+        if (isOrchestrator) {
+            const fragment = loadRoleFragment(config.projectRoot, config.role, 'lifecycle');
+            if (fragment) {
+                return fragment;
+            }
+        }
+        if (isOrchestrator || isTL) {
+            return this.buildFullLifecycle(config);
+        }
+        return this.buildWorkerLifecycle(config);
+    }
+    /**
+     * Full lifecycle for orchestrators and team leaders —
+     * includes proactive monitoring, cognitive loop, heartbeat, and session management.
+     */
+    buildFullLifecycle(config) {
+        const skillsPath = config.agentSkillsPath;
+        const sessionName = config.sessionName;
+        const projectPath = config.projectPath || config.projectRoot;
+        return `## Lifecycle Management
+
+### Cognitive Lifecycle (4 Stages)
+Continuously cycle through these stages during operation:
+
+1. **Intent** — Determine what needs to happen next (read tasks, check goals)
+2. **Observation** — Gather current state (team status, blockers, progress)
+3. **Strategy** — Decide the best approach (delegate, implement, escalate)
+4. **Adaptation** — Learn from results, adjust approach for next cycle
+
+### Proactive Monitoring
+- Periodically check team member status for idle/error states
+- Use \`schedule-check\` to set follow-up reminders after delegations
+- Monitor for stale tasks — if no progress in 15 minutes, investigate
+- Track context window usage — save progress before running low
+
+### Auto Progress Heartbeat
+Report your status periodically to maintain visibility:
+\`\`\`bash
+bash ${skillsPath}/core/report-status/execute.sh '{"sessionName":"${sessionName}","status":"in_progress","summary":"<current activity>","projectPath":"${projectPath}"}'
+\`\`\`
+
+### Session Management
+- **On startup**: Execute recovery protocol, load context, check pending work
+- **During work**: Report progress, save learnings, delegate effectively
+- **Before context runs low**: Save current state via \`record-learning\`
+- **On shutdown**: Generate session summary for next session handoff
+
+### Daily Workflow
+1. Start → Recovery protocol → Check pending tasks
+2. Process incoming messages and events
+3. Execute cognitive lifecycle loop (Intent → Observation → Strategy → Adaptation)
+4. Report progress at natural milestones
+5. Save learnings and handoff summary before session ends`;
+    }
+    /**
+     * Compact lifecycle for workers — work rhythm and context management only.
+     */
+    buildWorkerLifecycle(config) {
+        const skillsPath = config.agentSkillsPath;
+        const sessionName = config.sessionName;
+        const projectPath = config.projectPath || config.projectRoot;
+        return `## Work Rhythm
+
+### On Session Start
+1. Execute recovery protocol (recall + get-my-context)
+2. Review recovered context for unfinished work or blockers
+3. Report readiness to team leader
+
+### During Work
+- Report progress periodically so your team leader stays informed
+- When you discover important patterns or gotchas, call \`record-learning\` immediately
+- If you feel your context window is getting large, save progress:
+\`\`\`bash
+bash ${skillsPath}/core/record-learning/execute.sh '{"agentId":"${sessionName}","agentRole":"${config.role}","projectPath":"${projectPath}","learning":"Current progress: [what was done]. Remaining: [what is left]. Key findings: [important notes]"}'
+\`\`\`
+
+### Before Context Runs Low
+- Proactively save your progress via \`record-learning\`
+- Report current status so the team leader can reassign if needed`;
+    }
+}
+//# sourceMappingURL=lifecycle.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/lifecycle.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/lifecycle.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IAC3B,IAAI,GAAG,WAAW,CAAC;IACnB,QAAQ,GAAG,EAAE,CAAC;IACd,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAEzC,qCAAqC;QACrC,IAAI,cAAc,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAChF,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,QAAQ,CAAC;YACjB,CAAC;QACF,CAAC;QACD,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,MAAoB;QAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAE7D,OAAO;;;;;;;;;;;;;;;;;;;OAmBF,UAAU,mDAAmD,WAAW,0EAA0E,WAAW;;;;;;;;;;;;;;0DAc1G,CAAC;IAC1D,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,MAAoB;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC;QAE7D,OAAO;;;;;;;;;;;;OAYF,UAAU,iDAAiD,WAAW,kBAAkB,MAAM,CAAC,IAAI,oBAAoB,WAAW;;;;;kEAKvE,CAAC;IAClE,CAAC;CACD"}

package/dist/cli/backend/src/services/ai/prompt-modules/markdown-file-module.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Base helper for prompt modules that load a markdown file from disk.
+ *
+ * DomainSOPModule and RiskPolicyModule share identical structure:
+ *   1. Check a config key to decide shouldInclude
+ *   2. Build a path from projectRoot + subDir + configValue
+ *   3. Read the file, format with a heading, or return a fallback
+ *
+ * This helper captures that pattern so each concrete module only
+ * supplies metadata (name, priority, heading label, config key, etc.).
+ *
+ * @module services/ai/prompt-modules/markdown-file-module
+ */
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Descriptor for a markdown-file-based prompt module.
+ * Concrete modules provide this to buildMarkdownFileModule().
+ */
+export interface MarkdownFileModuleDescriptor {
+    /** Module name used for logging */
+    name: string;
+    /** Assembly priority (lower = earlier) */
+    priority: number;
+    /** Token soft cap */
+    maxTokens: number;
+    /** Whether the module can be trimmed under token pressure */
+    compactable: boolean;
+    /** Sub-directory under config/ where files live (e.g. 'domain-sops') */
+    configSubDir: string;
+    /** File extension including the dot (e.g. '.sop.md') */
+    fileExtension: string;
+    /** Heading label used in output (e.g. 'Domain SOP') */
+    headingLabel: string;
+    /** Fallback description shown when file is missing */
+    missingFileHint: string;
+    /** Extracts the config value that determines inclusion and file lookup */
+    getConfigValue: (config: ModuleConfig) => string | undefined;
+}
+/**
+ * Build a PromptModule from a MarkdownFileModuleDescriptor.
+ *
+ * @param descriptor - Module metadata and behavior hooks
+ * @returns A fully implemented PromptModule
+ */
+export declare function buildMarkdownFileModule(descriptor: MarkdownFileModuleDescriptor): PromptModule;
+//# sourceMappingURL=markdown-file-module.d.ts.map

package/dist/cli/backend/src/services/ai/prompt-modules/markdown-file-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-file-module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/markdown-file-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC5C,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,4BAA4B,GAAG,YAAY,CA4B9F"}

package/dist/cli/backend/src/services/ai/prompt-modules/markdown-file-module.js

@@ -0,0 +1,44 @@
+/**
+ * Base helper for prompt modules that load a markdown file from disk.
+ *
+ * DomainSOPModule and RiskPolicyModule share identical structure:
+ *   1. Check a config key to decide shouldInclude
+ *   2. Build a path from projectRoot + subDir + configValue
+ *   3. Read the file, format with a heading, or return a fallback
+ *
+ * This helper captures that pattern so each concrete module only
+ * supplies metadata (name, priority, heading label, config key, etc.).
+ *
+ * @module services/ai/prompt-modules/markdown-file-module
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Build a PromptModule from a MarkdownFileModuleDescriptor.
+ *
+ * @param descriptor - Module metadata and behavior hooks
+ * @returns A fully implemented PromptModule
+ */
+export function buildMarkdownFileModule(descriptor) {
+    return {
+        name: descriptor.name,
+        priority: descriptor.priority,
+        maxTokens: descriptor.maxTokens,
+        compactable: descriptor.compactable,
+        shouldInclude(config) {
+            return !!descriptor.getConfigValue(config);
+        },
+        async build(config) {
+            const value = descriptor.getConfigValue(config);
+            const filePath = path.join(config.projectRoot, 'config', descriptor.configSubDir, `${value}${descriptor.fileExtension}`);
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8').trim();
+                return `## ${descriptor.headingLabel}: ${value}\n\n${content}`;
+            }
+            catch {
+                return `## ${descriptor.headingLabel}: ${value}\n\n_${descriptor.missingFileHint} ${filePath}. Create it to define ${descriptor.headingLabel.toLowerCase()}-specific procedures._`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=markdown-file-module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/markdown-file-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-file-module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/markdown-file-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AA4B7B;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAwC;IAC/E,OAAO;QACN,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;QAEnC,aAAa,CAAC,MAAoB;YACjC,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,MAAoB;YAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,MAAM,CAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CACzB,MAAM,CAAC,WAAW,EAClB,QAAQ,EACR,UAAU,CAAC,YAAY,EACvB,GAAG,KAAK,GAAG,UAAU,CAAC,aAAa,EAAE,CACrC,CAAC;YAEF,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,OAAO,MAAM,UAAU,CAAC,YAAY,KAAK,KAAK,OAAO,OAAO,EAAE,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,MAAM,UAAU,CAAC,YAAY,KAAK,KAAK,QAAQ,UAAU,CAAC,eAAe,IAAI,QAAQ,yBAAyB,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,wBAAwB,CAAC;YACpL,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/cli/backend/src/services/ai/prompt-modules/memory-reference.module.d.ts

@@ -0,0 +1,28 @@
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Memory reference module — tells the agent how to access and store memories.
+ *
+ * Consolidates memory routing rules and session recovery protocol
+ * into a single module. Contains "how-to" instructions, not actual data.
+ *
+ * Sources: Path A Steps 8+9, Path B Section 7.
+ */
+export declare class MemoryReferenceModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    /**
+     * Always included — memory access is fundamental to agent continuity.
+     */
+    shouldInclude(_config: ModuleConfig): boolean;
+    /**
+     * Build the memory reference section with routing rules
+     * that tell the agent where to store different types of knowledge.
+     *
+     * @param config - Module configuration
+     * @returns Formatted markdown memory reference section
+     */
+    build(_config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=memory-reference.module.d.ts.map

package/dist/cli/backend/src/services/ai/prompt-modules/memory-reference.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/memory-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAkBnD"}

package/dist/cli/backend/src/services/ai/prompt-modules/memory-reference.module.js

@@ -0,0 +1,46 @@
+/**
+ * Memory reference module — tells the agent how to access and store memories.
+ *
+ * Consolidates memory routing rules and session recovery protocol
+ * into a single module. Contains "how-to" instructions, not actual data.
+ *
+ * Sources: Path A Steps 8+9, Path B Section 7.
+ */
+export class MemoryReferenceModule {
+    name = 'memory_references';
+    priority = 4;
+    maxTokens = 500;
+    compactable = false;
+    /**
+     * Always included — memory access is fundamental to agent continuity.
+     */
+    shouldInclude(_config) {
+        return true;
+    }
+    /**
+     * Build the memory reference section with routing rules
+     * that tell the agent where to store different types of knowledge.
+     *
+     * @param config - Module configuration
+     * @returns Formatted markdown memory reference section
+     */
+    async build(_config) {
+        return `## Memory Routing Rules
+
+When you learn something worth remembering, store it in the **right place**:
+
+| What you learned | Where to store it | How |
+|---|---|---|
+| Team conventions, coding standards, project patterns, shared decisions | Crewly knowledge (project-wide) | \`remember\` with \`scope: "project"\`, \`category: "pattern"\` or \`"decision"\` |
+| User preferences, working style, role-specific tips | Crewly knowledge (agent-specific) | \`remember\` with \`scope: "agent"\`, \`category: "preference"\` or \`"fact"\` |
+| Gotchas, bugs, workarounds discovered during work | Crewly knowledge (project-wide) | \`remember\` with \`scope: "project"\`, \`category: "gotcha"\` |
+| Temporary task notes, in-progress state, scratch data | Project files or Claude native memory | Write to a file in the project, or keep in your conversation context |
+
+**Rules of thumb:**
+- If another agent or a future session would benefit → use \`remember\` with \`scope: "project"\`
+- If only YOU would benefit in future sessions → use \`remember\` with \`scope: "agent"\`
+- If it's only useful right now → keep it in your conversation context or a scratch file
+- **Never store secrets, credentials, or tokens** in any memory system`;
+    }
+}
+//# sourceMappingURL=memory-reference.module.js.map

package/dist/cli/backend/src/services/ai/prompt-modules/memory-reference.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/memory-reference.module.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACjC,IAAI,GAAG,mBAAmB,CAAC;IAC3B,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,GAAG,CAAC;IAChB,WAAW,GAAG,KAAK,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,OAAqB;QAChC,OAAO;;;;;;;;;;;;;;;uEAe8D,CAAC;IACvE,CAAC;CACD"}

package/dist/cli/backend/src/services/ai/prompt-modules/mission-context.module.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Mission Context module — auto-injects the agent's current mission /
+ * OKR context into the assembled prompt.
+ *
+ * Wraps `MissionContextService.getContextForAgent` and registers
+ * cleanly inside the live `PromptAssemblyService` pipeline. This is the
+ * production wire-in for Memory Phase 1 / fix #415; the older hook in
+ * `PromptGeneratorService.generateMemberPrompt` was on a dead code path.
+ *
+ * Behavior:
+ *   - Skipped when `teamId` is missing or `evalMode` is true.
+ *   - `build()` is fail-soft: any service error logs a warn and returns
+ *     `''` so the assembler never breaks because of a missing missions
+ *     directory or a malformed mission file.
+ *   - Uses `config.projectPath` as the source of truth — no `process.cwd()`.
+ *   - Forwards `teamSlug` for sub-OKR slug lookup and `teamAncestorIds`
+ *     so missions owned by parent teams in the OKR hierarchy are also
+ *     surfaced.
+ *
+ * @module services/ai/prompt-modules/mission-context.module
+ */
+import { MissionContextService } from '../../memory/mission-context.service.js';
+import { PromptModule, ModuleConfig } from './prompt-module.interface.js';
+/**
+ * Implements the PromptModule interface for the mission-context card.
+ */
+export declare class MissionContextModule implements PromptModule {
+    name: string;
+    priority: number;
+    maxTokens: number;
+    compactable: boolean;
+    private readonly logger;
+    private readonly service;
+    /**
+     * Construct the module. The service is resolved lazily through its
+     * singleton — passing one in is supported for tests.
+     *
+     * @param service - Optional override for the mission-context service
+     */
+    constructor(service?: MissionContextService);
+    /**
+     * Skip the card when the agent has no team (no scoping anchor) or
+     * the assembler is in eval mode (token-saving).
+     *
+     * @param config - Module configuration
+     * @returns true when the card should be built
+     */
+    shouldInclude(config: ModuleConfig): boolean;
+    /**
+     * Build the mission card by delegating to MissionContextService.
+     * Returns the empty string on any error or when there is nothing to
+     * surface.
+     *
+     * @param config - Module configuration with resolved project path,
+     *   team id, optional team slug and optional ancestor team ids.
+     * @returns Rendered mission card markdown or `''` to skip the section
+     */
+    build(config: ModuleConfig): Promise<string>;
+}
+//# sourceMappingURL=mission-context.module.d.ts.map

package/dist/cli/backend/src/services/ai/prompt-modules/mission-context.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-context.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/mission-context.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAiB1E;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACxD,IAAI,SAAqB;IACzB,QAAQ,SAA4B;IACpC,SAAS,SAA8B;IACvC,WAAW,UAAQ;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,qBAAqB;IAK3C;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAM5C;;;;;;;;OAQG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAyBlD"}