crewly 1.8.9 → 1.8.12

package/dist/backend/backend/src/types/auto-assign.types.js

@@ -0,0 +1,136 @@
+/**
+ * Auto-Assignment Type Definitions
+ *
+ * Types for the automatic task assignment system.
+ *
+ * @module types/auto-assign.types
+ */
+// ======================
+// Constants
+// ======================
+/**
+ * Auto-assignment related constants
+ */
+export const AUTO_ASSIGN_CONSTANTS = {
+    /** Default configuration values */
+    DEFAULTS: {
+        MAX_CONCURRENT_TASKS: 1,
+        MAX_ASSIGNMENTS_PER_DAY: 50,
+        COOLDOWN_BETWEEN_TASKS: 60, // seconds
+        IDLE_THRESHOLD_MINUTES: 5,
+    },
+    /** Task type categories */
+    TASK_TYPES: {
+        DEVELOPMENT: ['feature', 'fix', 'refactor', 'implement'],
+        TESTING: ['test', 'verify', 'qa'],
+        FRONTEND: ['ui', 'component', 'style', 'frontend'],
+        BACKEND: ['api', 'service', 'database', 'backend'],
+        MANAGEMENT: ['planning', 'review', 'coordination', 'documentation'],
+    },
+    /** Priority levels */
+    PRIORITY: {
+        CRITICAL: 1,
+        HIGH: 2,
+        MEDIUM: 5,
+        LOW: 10,
+        BACKLOG: 20,
+    },
+    /** Configuration file paths */
+    PATHS: {
+        CONFIG_FILE: 'auto-assign.yaml',
+        CONFIG_DIR: '.crewly/config',
+    },
+};
+/**
+ * Default role matching rules
+ */
+export const DEFAULT_ROLE_MATCHING = [
+    {
+        role: 'developer',
+        taskTypes: ['feature', 'fix', 'refactor', 'test', 'implement'],
+        priority: 1,
+    },
+    {
+        role: 'frontend-developer',
+        taskTypes: ['feature', 'fix', 'ui', 'component', 'style', 'frontend'],
+        priority: 1,
+    },
+    {
+        role: 'backend-developer',
+        taskTypes: ['feature', 'fix', 'api', 'service', 'database', 'backend'],
+        priority: 1,
+    },
+    {
+        role: 'qa',
+        taskTypes: ['test', 'review', 'verify', 'qa'],
+        priority: 1,
+        exclusive: true,
+    },
+    {
+        role: 'tester',
+        taskTypes: ['test', 'review', 'verify'],
+        priority: 2,
+    },
+    {
+        role: 'pm',
+        taskTypes: ['planning', 'review', 'coordination', 'documentation'],
+        priority: 1,
+    },
+    {
+        role: 'tpm',
+        taskTypes: ['planning', 'coordination', 'tracking'],
+        priority: 1,
+    },
+    {
+        role: 'pgm',
+        taskTypes: ['planning', 'management', 'coordination'],
+        priority: 1,
+    },
+    {
+        role: 'designer',
+        taskTypes: ['design', 'ui', 'ux', 'mockup'],
+        priority: 1,
+        exclusive: true,
+    },
+];
+/**
+ * Default assignment strategy
+ */
+export const DEFAULT_ASSIGNMENT_STRATEGY = {
+    prioritization: 'priority',
+    roleMatching: DEFAULT_ROLE_MATCHING,
+    loadBalancing: {
+        enabled: true,
+        maxConcurrentTasks: AUTO_ASSIGN_CONSTANTS.DEFAULTS.MAX_CONCURRENT_TASKS,
+        preferIdleAgents: true,
+    },
+    dependencies: {
+        respectBlocking: true,
+        waitForDependencies: true,
+    },
+};
+/**
+ * Default notification configuration
+ */
+export const DEFAULT_NOTIFICATION_CONFIG = {
+    notifyOnIdle: true,
+    idleThresholdMinutes: AUTO_ASSIGN_CONSTANTS.DEFAULTS.IDLE_THRESHOLD_MINUTES,
+    notifyOnNoTasks: true,
+};
+/**
+ * Default assignment limits
+ */
+export const DEFAULT_ASSIGNMENT_LIMITS = {
+    maxAssignmentsPerDay: AUTO_ASSIGN_CONSTANTS.DEFAULTS.MAX_ASSIGNMENTS_PER_DAY,
+    cooldownBetweenTasks: AUTO_ASSIGN_CONSTANTS.DEFAULTS.COOLDOWN_BETWEEN_TASKS,
+};
+/**
+ * Default complete auto-assignment configuration
+ */
+export const DEFAULT_AUTO_ASSIGN_CONFIG = {
+    enabled: true,
+    strategy: DEFAULT_ASSIGNMENT_STRATEGY,
+    notifications: DEFAULT_NOTIFICATION_CONFIG,
+    limits: DEFAULT_ASSIGNMENT_LIMITS,
+};
+//# sourceMappingURL=auto-assign.types.js.map

package/dist/backend/backend/src/types/auto-assign.types.js.map

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

package/dist/backend/backend/src/types/cron-task.types.d.ts

@@ -46,9 +46,24 @@ export interface CronTask {
      *   - `agent_offline_start_failed` — callback threw or returned false
      *   - `agent_offline_not_ready` — callback succeeded but agent
      *     didn't come online within the wait window
-     * Issue #305.
+     *   - `agent_offline_retries_exhausted` — transient retries (#611) ran
+     *     out; equivalent terminal-skip for the consumer
+     * Issue #305 / #611.
      */
     lastSkipReason?: string;
+    /**
+     * Transient-skip retry counter (#611, 2026-05-28). Incremented every
+     * time `agent_offline_not_ready` / `agent_offline_start_failed` would
+     * have produced a permanent skip; reset to 0 on any successful run.
+     * The cron-eval loop reads this to decide whether to push `nextRunAt`
+     * out by a short backoff (retry) vs. permanently skip the slot.
+     *
+     * Why a stored counter and not an in-memory one: cron eval can fire
+     * on a fresh process (restart) and we still want the retry budget to
+     * survive — otherwise a transient OS spike that happens to coincide
+     * with a backend bounce would defeat the retry mechanism entirely.
+     */
+    transientSkipAttempts?: number;
 }
 /**
  * Storage format for cron-tasks.json.

package/dist/backend/backend/src/types/cron-task.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron-task.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/cron-task.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IACnC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"cron-task.types.d.ts","sourceRoot":"","sources":["../../../../../backend/src/types/cron-task.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IACnC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/backend/backend/src/utils/esm-require.utils.d.ts

@@ -0,0 +1,111 @@
+/**
+ * ESM/CJS-dual-mode helpers for the lazy `nodeRequire` pattern.
+ *
+ * Background
+ * ----------
+ * Several services in this codebase use the canonical `nodeRequire` pattern
+ * (commit `070cd3e5` — `fix(esm): anchor createRequire to process.argv[1]`)
+ * to lazily load modules without forcing every test that transitively imports
+ * them to mock the dependency. The pattern looks like:
+ *
+ *     const nodeRequire: NodeRequire =
+ *       typeof require === 'function'
+ *         ? require
+ *         : createRequire(pathToFileURL(process.argv[1] || process.cwd()).href);
+ *
+ * That pattern works **only** for npm-package targets (e.g.
+ * `nodeRequire('better-sqlite3')`) — Node's resolver walks UP from the anchor
+ * (`process.argv[1]`) to find `node_modules`, so the anchor's exact location
+ * does not matter for package resolution.
+ *
+ * It silently breaks for **relative project paths** like
+ * `nodeRequire('../v3/request.service.js')`. In production ESM, the relative
+ * spec is resolved against `process.argv[1]` (the entry script) — NOT against
+ * the calling module — so the require fails with `Cannot find module …`. In
+ * tests (ts-jest CJS transpile) the per-module `require` parameter is used
+ * instead, so the relative spec resolves correctly against the calling file
+ * and the bug stays hidden.
+ *
+ * Symptom that motivated this helper: `core/get-my-active-work` returned 500
+ * with "Cannot find module '../v3/request.service.js'" because
+ * `ActiveWorkBriefingService.getInstance()` called
+ * `nodeRequire('../v3/request.service.js')` from
+ * `services/agent/active-work-briefing.service.js` while `nodeRequire` was
+ * anchored to `dist/backend/backend/src/index.js`.
+ *
+ * What this helper does
+ * ---------------------
+ * `resolveProjectModulePath(testRelativePath, prodPathFromEntryDir)` returns:
+ *
+ * 1. In test mode (`typeof require === 'function'` — ts-jest CJS) — the
+ *    `testRelativePath` unchanged, so the per-module CJS require resolves it
+ *    relative to the calling file (its existing, working behavior).
+ * 2. In production ESM — an absolute path computed by joining
+ *    `path.dirname(process.argv[1])` with `prodPathFromEntryDir`.
+ *    Absolute paths are accepted by `nodeRequire` regardless of anchor.
+ *
+ * Why this is two-arg rather than one
+ * -----------------------------------
+ * We considered single-arg variants:
+ *   • `import.meta.url` — triggers TS1343 under ts-jest's CJS target. Even with
+ *     `// @ts-expect-error`, ts-jest's transpile may still fail at parse.
+ *   • `new Function('return import.meta.url')()` — was tried (PR #323) and is
+ *     forbidden — `new Function` evaluates in non-module scope where
+ *     `import.meta` is a SyntaxError. Crashed production at startup.
+ *   • `eval('import.meta.url')` — works at runtime via direct-eval scope
+ *     inheritance, but trips ESLint `no-eval` and is fragile across engines.
+ *   • Stack-trace introspection — gross and slow.
+ *
+ * Asking the caller to spell out **two** equivalent paths (one usable from the
+ * caller's perspective, one usable from the entry script's perspective) is
+ * verbose but unambiguous, parse-clean under both TS targets, and free of any
+ * runtime tricks.
+ *
+ * Usage
+ * -----
+ *     // Caller is at `backend/src/services/agent/active-work-briefing.service.ts`
+ *     // Target is at `backend/src/services/v3/request.service.ts`
+ *     // Entry script (process.argv[1]) is `dist/backend/backend/src/index.js`
+ *     // → from the caller's perspective: `../v3/request.service.js`
+ *     // → from the entry-script-dir's perspective: `services/v3/request.service.js`
+ *
+ *     const spec = resolveProjectModulePath(
+ *       '../v3/request.service.js',
+ *       'services/v3/request.service.js',
+ *     );
+ *     const { RequestService } = nodeRequire(spec);
+ *
+ * Test guard
+ * ----------
+ * `esm-require.utils.test.ts` exercises both branches and locks the contract
+ * (test branch ↔ untouched relative path; prod branch ↔ absolute path joined
+ * to `process.argv[1]`'s dirname).
+ *
+ * @module utils/esm-require.utils
+ */
+/**
+ * Resolves a project-relative require spec to a string safe to pass to
+ * `nodeRequire` in both ts-jest CJS test mode and production ESM mode.
+ *
+ * @param testRelativePath - The require spec written from the calling file's
+ *   perspective. Used verbatim in test mode (ts-jest CJS) where each module
+ *   gets its own `require` and relative resolution Just Works. Example:
+ *   `'../v3/request.service.js'`.
+ * @param prodPathFromEntryDir - The require spec rewritten as a path under
+ *   `path.dirname(process.argv[1])`. Used in production ESM where
+ *   `nodeRequire` is anchored to the entry script. Example:
+ *   `'services/v3/request.service.js'` (under `dist/backend/backend/src/`).
+ * @returns A string suitable for `nodeRequire(...)`.
+ *
+ * @example
+ * ```typescript
+ * const { RequestService } = nodeRequire(
+ *   resolveProjectModulePath(
+ *     '../v3/request.service.js',
+ *     'services/v3/request.service.js',
+ *   ),
+ * );
+ * ```
+ */
+export declare function resolveProjectModulePath(testRelativePath: string, prodPathFromEntryDir: string): string;
+//# sourceMappingURL=esm-require.utils.d.ts.map

package/dist/backend/backend/src/utils/esm-require.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-require.utils.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/esm-require.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAYR"}

package/dist/backend/backend/src/utils/esm-require.utils.js

@@ -0,0 +1,124 @@
+/**
+ * ESM/CJS-dual-mode helpers for the lazy `nodeRequire` pattern.
+ *
+ * Background
+ * ----------
+ * Several services in this codebase use the canonical `nodeRequire` pattern
+ * (commit `070cd3e5` — `fix(esm): anchor createRequire to process.argv[1]`)
+ * to lazily load modules without forcing every test that transitively imports
+ * them to mock the dependency. The pattern looks like:
+ *
+ *     const nodeRequire: NodeRequire =
+ *       typeof require === 'function'
+ *         ? require
+ *         : createRequire(pathToFileURL(process.argv[1] || process.cwd()).href);
+ *
+ * That pattern works **only** for npm-package targets (e.g.
+ * `nodeRequire('better-sqlite3')`) — Node's resolver walks UP from the anchor
+ * (`process.argv[1]`) to find `node_modules`, so the anchor's exact location
+ * does not matter for package resolution.
+ *
+ * It silently breaks for **relative project paths** like
+ * `nodeRequire('../v3/request.service.js')`. In production ESM, the relative
+ * spec is resolved against `process.argv[1]` (the entry script) — NOT against
+ * the calling module — so the require fails with `Cannot find module …`. In
+ * tests (ts-jest CJS transpile) the per-module `require` parameter is used
+ * instead, so the relative spec resolves correctly against the calling file
+ * and the bug stays hidden.
+ *
+ * Symptom that motivated this helper: `core/get-my-active-work` returned 500
+ * with "Cannot find module '../v3/request.service.js'" because
+ * `ActiveWorkBriefingService.getInstance()` called
+ * `nodeRequire('../v3/request.service.js')` from
+ * `services/agent/active-work-briefing.service.js` while `nodeRequire` was
+ * anchored to `dist/backend/backend/src/index.js`.
+ *
+ * What this helper does
+ * ---------------------
+ * `resolveProjectModulePath(testRelativePath, prodPathFromEntryDir)` returns:
+ *
+ * 1. In test mode (`typeof require === 'function'` — ts-jest CJS) — the
+ *    `testRelativePath` unchanged, so the per-module CJS require resolves it
+ *    relative to the calling file (its existing, working behavior).
+ * 2. In production ESM — an absolute path computed by joining
+ *    `path.dirname(process.argv[1])` with `prodPathFromEntryDir`.
+ *    Absolute paths are accepted by `nodeRequire` regardless of anchor.
+ *
+ * Why this is two-arg rather than one
+ * -----------------------------------
+ * We considered single-arg variants:
+ *   • `import.meta.url` — triggers TS1343 under ts-jest's CJS target. Even with
+ *     `// @ts-expect-error`, ts-jest's transpile may still fail at parse.
+ *   • `new Function('return import.meta.url')()` — was tried (PR #323) and is
+ *     forbidden — `new Function` evaluates in non-module scope where
+ *     `import.meta` is a SyntaxError. Crashed production at startup.
+ *   • `eval('import.meta.url')` — works at runtime via direct-eval scope
+ *     inheritance, but trips ESLint `no-eval` and is fragile across engines.
+ *   • Stack-trace introspection — gross and slow.
+ *
+ * Asking the caller to spell out **two** equivalent paths (one usable from the
+ * caller's perspective, one usable from the entry script's perspective) is
+ * verbose but unambiguous, parse-clean under both TS targets, and free of any
+ * runtime tricks.
+ *
+ * Usage
+ * -----
+ *     // Caller is at `backend/src/services/agent/active-work-briefing.service.ts`
+ *     // Target is at `backend/src/services/v3/request.service.ts`
+ *     // Entry script (process.argv[1]) is `dist/backend/backend/src/index.js`
+ *     // → from the caller's perspective: `../v3/request.service.js`
+ *     // → from the entry-script-dir's perspective: `services/v3/request.service.js`
+ *
+ *     const spec = resolveProjectModulePath(
+ *       '../v3/request.service.js',
+ *       'services/v3/request.service.js',
+ *     );
+ *     const { RequestService } = nodeRequire(spec);
+ *
+ * Test guard
+ * ----------
+ * `esm-require.utils.test.ts` exercises both branches and locks the contract
+ * (test branch ↔ untouched relative path; prod branch ↔ absolute path joined
+ * to `process.argv[1]`'s dirname).
+ *
+ * @module utils/esm-require.utils
+ */
+import path from 'path';
+/**
+ * Resolves a project-relative require spec to a string safe to pass to
+ * `nodeRequire` in both ts-jest CJS test mode and production ESM mode.
+ *
+ * @param testRelativePath - The require spec written from the calling file's
+ *   perspective. Used verbatim in test mode (ts-jest CJS) where each module
+ *   gets its own `require` and relative resolution Just Works. Example:
+ *   `'../v3/request.service.js'`.
+ * @param prodPathFromEntryDir - The require spec rewritten as a path under
+ *   `path.dirname(process.argv[1])`. Used in production ESM where
+ *   `nodeRequire` is anchored to the entry script. Example:
+ *   `'services/v3/request.service.js'` (under `dist/backend/backend/src/`).
+ * @returns A string suitable for `nodeRequire(...)`.
+ *
+ * @example
+ * ```typescript
+ * const { RequestService } = nodeRequire(
+ *   resolveProjectModulePath(
+ *     '../v3/request.service.js',
+ *     'services/v3/request.service.js',
+ *   ),
+ * );
+ * ```
+ */
+export function resolveProjectModulePath(testRelativePath, prodPathFromEntryDir) {
+    // The same `typeof require` probe the canonical `nodeRequire` pattern uses.
+    // Under ts-jest's CJS transpile, the per-module `require` parameter is
+    // defined and is the correct anchor for relative resolution. Under
+    // production ESM, `require` is undefined globally and we must hand
+    // `nodeRequire` an absolute path.
+    if (typeof require === 'function') {
+        return testRelativePath;
+    }
+    const entryScript = process.argv[1] || process.cwd();
+    const entryDir = path.dirname(entryScript);
+    return path.join(entryDir, prodPathFromEntryDir);
+}
+//# sourceMappingURL=esm-require.utils.js.map

package/dist/backend/backend/src/utils/esm-require.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-require.utils.js","sourceRoot":"","sources":["../../../../../backend/src/utils/esm-require.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,wBAAwB,CACtC,gBAAwB,EACxB,oBAA4B;IAE5B,4EAA4E;IAC5E,uEAAuE;IACvE,mEAAmE;IACnE,mEAAmE;IACnE,kCAAkC;IAClC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,220 @@
+/**
+ * Interface for modular prompt components.
+ *
+ * Each module is responsible for one concern (identity, skills, team, etc.)
+ * and produces a markdown string that gets assembled into the final agent prompt.
+ *
+ * Modules are assembled in priority order (1 = highest, assembled first).
+ * Non-compactable modules are never truncated when token budget is tight.
+ */
+/**
+ * Configuration passed to each prompt module during assembly.
+ * Contains all the context needed to build module-specific content.
+ */
+/**
+ * Organizational role derived from team hierarchy.
+ * Determines role boundary rules and event subscriptions.
+ */
+export type OrgRole = 'orchestrator' | 'team-lead' | 'executor';
+/**
+ * Autonomy level controls the decision rights matrix.
+ * - directed: Execute assigned tasks only, escalate all ambiguity.
+ * - bounded: Make decisions within task/domain scope, log rationale.
+ * - domain_autonomous: Monitor domain continuously, make approved decisions without waiting.
+ */
+export type AutonomyLevel = 'directed' | 'bounded' | 'domain_autonomous';
+export interface ModuleConfig {
+    /** Agent's session name (e.g. 'crewly-product-sam-217bfbbf') */
+    sessionName: string;
+    /** Agent's member ID (UUID) */
+    memberId: string;
+    /** Agent's role (e.g. 'developer', 'orchestrator') */
+    role: string;
+    /** Team ID this agent belongs to */
+    teamId?: string;
+    /** Absolute path to the project directory */
+    projectPath?: string;
+    /** Runtime type determines formatting and injection strategy */
+    runtimeType?: 'claude-code' | 'gemini-cli' | 'codex' | 'crewly-agent';
+    /** Whether this agent can delegate tasks to subordinates */
+    canDelegate?: boolean;
+    /** Resolved subordinate details for TL agents */
+    subordinates?: SubordinateInfoCompat[];
+    /** Absolute path to agent skill scripts */
+    agentSkillsPath: string;
+    /** Absolute path to team-leader skill scripts */
+    tlSkillsPath: string;
+    /** Absolute path to the project root (where config/ lives) */
+    projectRoot: string;
+    /** Organizational role derived from team hierarchy (orchestrator, team-lead, executor) */
+    orgRole?: OrgRole;
+    /** Autonomy level controlling the decision rights matrix */
+    autonomyLevel?: AutonomyLevel;
+    /** Capability flags (e.g., ['can-decide', 'can-verify']) */
+    capabilities?: string[];
+    /** Domain SOP name — loads config/domain-sops/{domainSOP}.sop.md */
+    domainSOP?: string;
+    /** Risk policy name — loads config/risk-policies/{riskPolicy}.policy.md */
+    riskPolicy?: string;
+    /** Job title for this position: "Frontend Tech Lead" */
+    jobTitle?: string;
+    /** What this member is responsible for */
+    jobDescription?: string;
+    /** Member-level ownership scope */
+    ownershipScope?: {
+        domains: string[];
+        deliverables: string[];
+        areas?: string[];
+    };
+    /** Team-level ownership scope */
+    teamOwnershipScope?: {
+        domains: string[];
+        deliverables: string[];
+        areas?: string[];
+    };
+    /** Team's service contract */
+    serviceContract?: {
+        accepts: string[];
+        avoids: string[];
+        expectedOutput: string[];
+    };
+    /** Expert profile ID — loads config/experts/{expertId}.md or Pro expert library */
+    expertId?: string;
+    /** Team description — injected into agent prompt to guide team-aligned behavior */
+    teamDescription?: string;
+    /** Team mission / OKR statement — injected into agent prompt for goal alignment */
+    teamMission?: string;
+    /** Team budget configuration — injected so agents can respect cost constraints */
+    teamBudget?: {
+        maxTokensPerDay?: number;
+        maxUsdPerMonth?: number;
+        alertThreshold?: number;
+    };
+    /** Team quality gate — injected so agents know review requirements */
+    teamQualityGate?: {
+        reviewerId?: string;
+        autoApprove?: boolean;
+        minQualityScore?: number;
+    };
+    /** Absolute path to team norms directory (from template application) */
+    teamNormsPath?: string;
+    /**
+     * Human-readable team slug used for resolving slug-named team files
+     * (e.g. `<teamSlug>-team-sub-okr.md` under `.crewly/goals/`).
+     * Populated by PromptBuilderService from team metadata when available.
+     * Optional — modules MUST tolerate undefined and skip slug-dependent
+     * sections silently.
+     */
+    teamSlug?: string;
+    /**
+     * Team-graph ancestor IDs (parent, grandparent, ...) used by modules
+     * that need to surface inherited org context such as parent-team
+     * missions / OKRs. Caller resolves the chain; modules consume it
+     * read-only. Empty / undefined means "no ancestors" — modules MUST
+     * default to a single-team view rather than error.
+     */
+    teamAncestorIds?: string[];
+    /**
+     * When true, the prompt assembler skips non-core modules to reduce token usage
+     * during eval runs. Core modules: identity, soul, role-boundary, recovery.
+     */
+    evalMode?: boolean;
+}
+/**
+ * Subordinate info compatible with the existing SubordinateInfo type
+ */
+export interface SubordinateInfoCompat {
+    name: string;
+    sessionName: string;
+    role: string;
+    memberId: string;
+}
+/**
+ * Result of building a single prompt module.
+ * Includes the content and metadata for budget tracking.
+ */
+export interface ModuleBuildResult {
+    /** Module name */
+    name: string;
+    /** Generated markdown content */
+    content: string;
+    /** Estimated token count of the content */
+    estimatedTokens: number;
+}
+/**
+ * Interface that all prompt modules must implement.
+ *
+ * @example
+ * ```typescript
+ * class IdentityModule implements PromptModule {
+ *   name = 'identity';
+ *   priority = 1;
+ *   maxTokens = 150;
+ *   compactable = false;
+ *
+ *   shouldInclude(_config: ModuleConfig): boolean { return true; }
+ *
+ *   async build(config: ModuleConfig): Promise<string> {
+ *     return `## Your Identity\n- **Session Name:** ${config.sessionName}`;
+ *   }
+ * }
+ * ```
+ */
+export interface PromptModule {
+    /** Module name (used for logging and debugging) */
+    name: string;
+    /** Assembly priority (1 = highest, assembled first) */
+    priority: number;
+    /** Token soft cap for this module */
+    maxTokens: number;
+    /** Whether this module can be skipped when token budget is tight */
+    compactable: boolean;
+    /** Condition check — return false to skip this module */
+    shouldInclude(config: ModuleConfig): boolean;
+    /** Build module content as markdown string */
+    build(config: ModuleConfig): Promise<string>;
+}
+/**
+ * Report returned by PromptAssemblyService.assemble() describing
+ * token usage and any truncation that occurred.
+ */
+export interface AssemblyReport {
+    /** Total estimated tokens in the final prompt */
+    totalTokens: number;
+    /** Per-module token breakdown */
+    moduleBreakdown: ModuleBuildResult[];
+    /** Modules that were truncated or removed to fit budget */
+    truncated: TruncatedModuleInfo[];
+}
+/**
+ * Info about a module that was truncated or removed during assembly.
+ */
+export interface TruncatedModuleInfo {
+    /** Module name */
+    name: string;
+    /** Original estimated tokens before truncation */
+    originalTokens: number;
+    /** Tokens after truncation (0 if fully removed) */
+    finalTokens: number;
+    /** What happened: 'trimmed' (to 50%) or 'removed' (dropped entirely) */
+    action: 'trimmed' | 'removed';
+}
+/**
+ * Load a role-specific fragment file from config/roles/{role}/fragments/{fragmentName}.md.
+ * Returns null if the file doesn't exist.
+ *
+ * @param projectRoot - Project root path (where config/ lives)
+ * @param role - Agent role (e.g. 'orchestrator')
+ * @param fragmentName - Fragment file name without .md extension
+ * @returns Fragment content string or null
+ */
+export declare function loadRoleFragment(projectRoot: string, role: string, fragmentName: string): string | null;
+/**
+ * Estimate token count from a string.
+ * Uses the rough heuristic of ~4 characters per token (suitable for English/code mix).
+ *
+ * @param text - Text to estimate tokens for
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=prompt-module.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-module.interface.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/prompt-module.interface.ts"],"names":[],"mappings":"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"}