crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/observability/agent-behavior-log.types.js

@@ -0,0 +1,48 @@
+/**
+ * Agent Behavior Log — event type definitions.
+ *
+ * The behavior log is a single-table append-only event store backing
+ * Crewly's minimal internal metrics. Each entry is a strongly-typed
+ * domain event the platform records for later analysis (delegation
+ * rates, escalation patterns, Slack delivery failures, prompt size
+ * trends).
+ *
+ * Schema lives in `observability-db.ts`. Service API in
+ * `agent-behavior-log.service.ts`.
+ *
+ * @module services/observability/agent-behavior-log.types
+ */
+// ---------------------------------------------------------------------------
+// Event-type discriminator
+// ---------------------------------------------------------------------------
+/**
+ * Canonical event type strings stored in the `event_type` column of
+ * `agent_behavior_log`. Adding a new event type is additive — append a
+ * new constant here AND extend `BehaviorLogEvent` below; do not rename
+ * existing values (downstream digests rely on stable keys).
+ */
+export const BEHAVIOR_LOG_EVENT_TYPES = {
+    /** An agent took a top-level action (delegate, implement, ask_human, send_slack, ...). */
+    AGENT_ACTION: 'agent.action',
+    /** An agent escalated a decision/issue to a higher level in the chain. */
+    AGENT_ESCALATION: 'agent.escalation',
+    /** A Slack message could not be delivered (intended-but-not-sent or API failure). */
+    SLACK_DELIVERY_FAILED: 'slack.delivery.failed',
+    /** Snapshot of an agent's compiled prompt size at session/start build time. */
+    PROMPT_SIZE_BYTES: 'prompt.size.bytes',
+};
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+/**
+ * Return true if `value` looks like a known `BehaviorLogEventType`.
+ *
+ * Useful at deserialisation boundaries (e.g. when querying historic
+ * rows) to narrow a generic string into the discriminator union.
+ *
+ * @param value - any string to test
+ */
+export function isBehaviorLogEventType(value) {
+    return (Object.values(BEHAVIOR_LOG_EVENT_TYPES).includes(value));
+}
+//# sourceMappingURL=agent-behavior-log.types.js.map

package/dist/cli/backend/src/services/observability/agent-behavior-log.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-behavior-log.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/observability/agent-behavior-log.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,0FAA0F;IAC1F,YAAY,EAAE,cAAc;IAC5B,0EAA0E;IAC1E,gBAAgB,EAAE,kBAAkB;IACpC,qFAAqF;IACrF,qBAAqB,EAAE,uBAAuB;IAC9C,+EAA+E;IAC/E,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAwHX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,CACL,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,KAA6B,CAAC,CAChF,CAAC;AACJ,CAAC"}

package/dist/cli/backend/src/services/observability/observability-db.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Observability SQLite bootstrap.
+ *
+ * Opens (or creates) `~/.crewly/observability.db` and applies the
+ * idempotent migration for `agent_behavior_log`. The schema is a
+ * single append-only table that backs Crewly's minimal internal
+ * metrics (delegate-first rate, escalation patterns, slack-delivery
+ * failure counters, prompt-size trends).
+ *
+ * This module mirrors the lazy `better-sqlite3` loader pattern from
+ * `services/chat-v2/sqlite/chat-db.ts` so the native module never
+ * loads at import time — only when an opener is first called.
+ *
+ * @module services/observability/observability-db
+ */
+import { type ComponentLogger } from '../core/logger.service.js';
+/** Type alias for a `better-sqlite3` Database instance. */
+export type ObservabilityDatabase = import('better-sqlite3').Database;
+/**
+ * Idempotent base DDL for the observability database.
+ *
+ * Single table strategy: every behavior event lives in
+ * `agent_behavior_log`, discriminated by `event_type`. Per-event-type
+ * payload variation is captured in the optional `subject`, `task_id`,
+ * `reason`, `amount`, and `details_json` columns. This keeps the
+ * schema small while supporting later additive event types without
+ * migrations.
+ *
+ * Indexes are scoped to the most common query shapes for the weekly
+ * digest (per-agent, per-event-type, per-time-window).
+ */
+export declare const OBSERVABILITY_MIGRATION_SQL = "\nCREATE TABLE IF NOT EXISTS agent_behavior_log (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  ts            INTEGER NOT NULL,\n  event_type    TEXT NOT NULL,\n  agent         TEXT NOT NULL DEFAULT '',\n  subject       TEXT NOT NULL DEFAULT '',\n  task_id       TEXT NOT NULL DEFAULT '',\n  reason        TEXT NOT NULL DEFAULT '',\n  amount        INTEGER NOT NULL DEFAULT 0,\n  details_json  TEXT NOT NULL DEFAULT '{}'\n);\n\nCREATE INDEX IF NOT EXISTS ix_behavior_log_ts\n  ON agent_behavior_log(ts);\n\nCREATE INDEX IF NOT EXISTS ix_behavior_log_event_ts\n  ON agent_behavior_log(event_type, ts);\n\nCREATE INDEX IF NOT EXISTS ix_behavior_log_agent_event_ts\n  ON agent_behavior_log(agent, event_type, ts);\n";
+/**
+ * Default on-disk path for the observability database.
+ *
+ * Lives next to the chat database under `~/.crewly/` so operators have a
+ * single directory to back up / inspect.
+ *
+ * @returns Absolute path to `~/.crewly/observability.db`
+ */
+export declare function defaultObservabilityDbPath(): string;
+/**
+ * Options accepted by `openObservabilityDatabase`.
+ */
+export interface OpenObservabilityDatabaseOptions {
+    /**
+     * Absolute path to the SQLite file. Parent directories are created
+     * as needed. Defaults to `defaultObservabilityDbPath()`.
+     */
+    dbPath?: string;
+    /**
+     * When true, uses SQLite `:memory:` regardless of `dbPath`. Intended
+     * for unit tests. Defaults to false.
+     */
+    inMemory?: boolean;
+    /**
+     * When true, suppress the integrity-check warning on open. Tests use
+     * this to avoid noisy logs. Defaults to false.
+     */
+    skipIntegrityCheck?: boolean;
+    /** Optional logger override — defaults to `LoggerService`. */
+    logger?: ComponentLogger;
+}
+/**
+ * Open (or create) the observability database, apply PRAGMAs, run the
+ * idempotent migration, and run a boot-time integrity check.
+ *
+ * Safe to call multiple times during a single process lifetime — each
+ * call returns a fresh `Database` handle the caller is responsible for
+ * closing. In production, code should hold a single shared handle and
+ * close it during graceful shutdown.
+ *
+ * @param options - Opener options
+ * @returns A ready-to-use better-sqlite3 Database handle
+ *
+ * @example
+ * ```ts
+ * const db = openObservabilityDatabase();
+ * // ... use db ...
+ * db.close();
+ * ```
+ */
+export declare function openObservabilityDatabase(options?: OpenObservabilityDatabaseOptions): ObservabilityDatabase;
+//# sourceMappingURL=observability-db.d.ts.map

package/dist/cli/backend/src/services/observability/observability-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-db.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/observability/observability-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AA+ChF,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAAG,OAAO,gBAAgB,EAAE,QAAQ,CAAC;AAMtE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,stBAqBvC,CAAC;AAMF;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAMD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC,GAC7C,qBAAqB,CAgDvB"}

package/dist/cli/backend/src/services/observability/observability-db.js

@@ -0,0 +1,165 @@
+/**
+ * Observability SQLite bootstrap.
+ *
+ * Opens (or creates) `~/.crewly/observability.db` and applies the
+ * idempotent migration for `agent_behavior_log`. The schema is a
+ * single append-only table that backs Crewly's minimal internal
+ * metrics (delegate-first rate, escalation patterns, slack-delivery
+ * failure counters, prompt-size trends).
+ *
+ * This module mirrors the lazy `better-sqlite3` loader pattern from
+ * `services/chat-v2/sqlite/chat-db.ts` so the native module never
+ * loads at import time — only when an opener is first called.
+ *
+ * @module services/observability/observability-db
+ */
+import * as path from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { createBareModuleRequire } from '../../utils/node-require.utils.js';
+import { loadNativeAddonOrFatal } from '../../utils/native-binding.utils.js';
+import { LoggerService } from '../core/logger.service.js';
+import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
+// ---------------------------------------------------------------------------
+// Lazy better-sqlite3 loader (same pattern as chat-db.ts)
+// ---------------------------------------------------------------------------
+/**
+ * CJS-style `require` scoped to this module. `better-sqlite3` is a
+ * native addon and must be loaded via CJS `require`, but this module
+ * compiles to ESM where the bare `require` global is undefined.
+ *
+ * Anchor: see `backend/src/utils/node-require.utils.ts` — the helper
+ * hides `import.meta.url` behind direct `eval` so ts-jest's CommonJS
+ * transpile does not see the meta-property token. The createRequire
+ * anchor is THIS file's URL.
+ */
+const nodeRequire = createBareModuleRequire(typeof require === 'function' ? require : null);
+/** Cached reference to the better-sqlite3 module after first successful load. */
+let _BetterSqlite3 = null;
+/**
+ * Load `better-sqlite3` on demand.
+ *
+ * F-CYCLE7-1: native-addon failures matching dlopen / arch-mismatch /
+ * ABI patterns are escalated to {@link NativeBindingFatalError} via
+ * {@link loadNativeAddonOrFatal}, so the gateway-layer try/catch in
+ * `backend/src/index.ts` can rethrow them and crash boot rather than
+ * downgrade silently. Non-arch errors (`Cannot find module`, etc.)
+ * bubble up unchanged.
+ *
+ * @returns The lazily-imported better-sqlite3 module
+ * @throws {NativeBindingFatalError} on dlopen / arch / ABI mismatches
+ */
+function getBetterSqlite3() {
+    if (!_BetterSqlite3) {
+        _BetterSqlite3 = loadNativeAddonOrFatal('better-sqlite3', nodeRequire);
+    }
+    return _BetterSqlite3;
+}
+// ---------------------------------------------------------------------------
+// Migration DDL
+// ---------------------------------------------------------------------------
+/**
+ * Idempotent base DDL for the observability database.
+ *
+ * Single table strategy: every behavior event lives in
+ * `agent_behavior_log`, discriminated by `event_type`. Per-event-type
+ * payload variation is captured in the optional `subject`, `task_id`,
+ * `reason`, `amount`, and `details_json` columns. This keeps the
+ * schema small while supporting later additive event types without
+ * migrations.
+ *
+ * Indexes are scoped to the most common query shapes for the weekly
+ * digest (per-agent, per-event-type, per-time-window).
+ */
+export const OBSERVABILITY_MIGRATION_SQL = `
+CREATE TABLE IF NOT EXISTS agent_behavior_log (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts            INTEGER NOT NULL,
+  event_type    TEXT NOT NULL,
+  agent         TEXT NOT NULL DEFAULT '',
+  subject       TEXT NOT NULL DEFAULT '',
+  task_id       TEXT NOT NULL DEFAULT '',
+  reason        TEXT NOT NULL DEFAULT '',
+  amount        INTEGER NOT NULL DEFAULT 0,
+  details_json  TEXT NOT NULL DEFAULT '{}'
+);
+
+CREATE INDEX IF NOT EXISTS ix_behavior_log_ts
+  ON agent_behavior_log(ts);
+
+CREATE INDEX IF NOT EXISTS ix_behavior_log_event_ts
+  ON agent_behavior_log(event_type, ts);
+
+CREATE INDEX IF NOT EXISTS ix_behavior_log_agent_event_ts
+  ON agent_behavior_log(agent, event_type, ts);
+`;
+// ---------------------------------------------------------------------------
+// Default path
+// ---------------------------------------------------------------------------
+/**
+ * Default on-disk path for the observability database.
+ *
+ * Lives next to the chat database under `~/.crewly/` so operators have a
+ * single directory to back up / inspect.
+ *
+ * @returns Absolute path to `~/.crewly/observability.db`
+ */
+export function defaultObservabilityDbPath() {
+    return path.join(getCrewlyHomePath(), 'observability.db');
+}
+/**
+ * Open (or create) the observability database, apply PRAGMAs, run the
+ * idempotent migration, and run a boot-time integrity check.
+ *
+ * Safe to call multiple times during a single process lifetime — each
+ * call returns a fresh `Database` handle the caller is responsible for
+ * closing. In production, code should hold a single shared handle and
+ * close it during graceful shutdown.
+ *
+ * @param options - Opener options
+ * @returns A ready-to-use better-sqlite3 Database handle
+ *
+ * @example
+ * ```ts
+ * const db = openObservabilityDatabase();
+ * // ... use db ...
+ * db.close();
+ * ```
+ */
+export function openObservabilityDatabase(options = {}) {
+    const logger = options.logger ??
+        LoggerService.getInstance().createComponentLogger('ObservabilityDb');
+    const dbPath = options.dbPath ?? defaultObservabilityDbPath();
+    if (!options.inMemory) {
+        const dir = path.dirname(dbPath);
+        if (dir && dir !== '.' && !existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    const Database = getBetterSqlite3();
+    const target = options.inMemory ? ':memory:' : dbPath;
+    const db = new Database(target);
+    // PRAGMAs — must be set outside any transaction.
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    // Apply migration idempotently. `exec` accepts multiple statements.
+    db.exec(OBSERVABILITY_MIGRATION_SQL);
+    if (!options.skipIntegrityCheck) {
+        try {
+            const rows = db.pragma('integrity_check');
+            const first = rows[0]?.integrity_check;
+            if (first && first !== 'ok') {
+                logger.warn('Observability DB integrity check reported issues', {
+                    result: first,
+                });
+            }
+        }
+        catch (err) {
+            logger.warn('Observability DB integrity check threw — continuing without gating startup', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    logger.info('Observability DB opened', { path: target });
+    return db;
+}
+//# sourceMappingURL=observability-db.js.map

package/dist/cli/backend/src/services/observability/observability-db.js.map

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

package/dist/cli/backend/src/services/onboarding/content-approval.service.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Content Approval Service for Marketing Team templates.
+ *
+ * Manages the approval workflow where marketing agents submit content
+ * for human review. Content can be approved/rejected via:
+ *   - Slack text replies ("approve" / "reject")
+ *   - REST API endpoints
+ *
+ * This service is designed for the marketing team use case and is
+ * separate from the F27 ToolApprovalQueue (which handles tool execution).
+ *
+ * @module content-approval-service
+ */
+import { ApprovalResolution, ContentApprovalRequest, ContentApprovalStatus, SubmitForApprovalOptions } from './content-approval.types.js';
+/**
+ * Service managing content approval requests for marketing teams.
+ *
+ * Follows singleton pattern. Stores approvals in memory with optional
+ * Slack message tracking for interactive approval via text replies.
+ */
+export declare class ContentApprovalService {
+    private static instance;
+    private approvals;
+    /**
+     * Get or create the singleton instance.
+     *
+     * @returns Singleton instance
+     */
+    static getInstance(): ContentApprovalService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Submit content for approval.
+     *
+     * @param options - Content submission details
+     * @returns Created approval request
+     * @throws Error if team has too many pending approvals
+     */
+    submit(options: SubmitForApprovalOptions): ContentApprovalRequest;
+    /**
+     * Approve a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who approved (user ID or identifier)
+     * @param feedback - Optional feedback or notes
+     * @returns Updated approval request or null if not found
+     */
+    approve(approvalId: string, resolvedBy: string, feedback?: string): ContentApprovalRequest | null;
+    /**
+     * Reject a content request.
+     *
+     * @param approvalId - ID of the approval request
+     * @param resolvedBy - Who rejected
+     * @param feedback - Reason for rejection or edit instructions
+     * @returns Updated approval request or null if not found
+     */
+    reject(approvalId: string, resolvedBy: string, feedback?: string): ContentApprovalRequest | null;
+    /**
+     * Resolve an approval request (approve or reject).
+     *
+     * @param resolution - Resolution details
+     * @returns Updated request or null
+     */
+    resolve(resolution: ApprovalResolution): ContentApprovalRequest | null;
+    /**
+     * Get a specific approval request.
+     *
+     * @param approvalId - Approval ID
+     * @returns The request or null
+     */
+    get(approvalId: string): ContentApprovalRequest | null;
+    /**
+     * Get all pending approvals for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Array of pending approval requests
+     */
+    getPendingByTeam(teamId: string): ContentApprovalRequest[];
+    /**
+     * Get all approvals for a team (all statuses).
+     *
+     * @param teamId - Team ID
+     * @returns Array of all approval requests
+     */
+    getAllByTeam(teamId: string): ContentApprovalRequest[];
+    /**
+     * Get approval by Slack message timestamp (for Slack reply-based approval).
+     *
+     * @param channelId - Slack channel ID
+     * @param messageTs - Slack message timestamp
+     * @returns Matching approval request or null
+     */
+    getBySlackMessage(channelId: string, messageTs: string): ContentApprovalRequest | null;
+    /**
+     * Link a Slack message to an approval request (for tracking replies).
+     *
+     * @param approvalId - Approval ID
+     * @param channelId - Slack channel where the approval message was posted
+     * @param messageTs - Slack message timestamp
+     * @returns Updated request or null
+     */
+    linkSlackMessage(approvalId: string, channelId: string, messageTs: string): ContentApprovalRequest | null;
+    /**
+     * Get counts by status for a team.
+     *
+     * @param teamId - Team ID
+     * @returns Object with status counts
+     */
+    getStats(teamId: string): Record<ContentApprovalStatus, number>;
+    /**
+     * Format an approval request as a Slack message (plain text for MVP).
+     *
+     * @param request - The approval request to format
+     * @returns Formatted message string ready for Slack
+     */
+    formatForSlack(request: ContentApprovalRequest): string;
+    /**
+     * Expire old pending approvals past the TTL.
+     */
+    private expireOldApprovals;
+}
+//# sourceMappingURL=content-approval.service.d.ts.map

package/dist/cli/backend/src/services/onboarding/content-approval.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-approval.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/onboarding/content-approval.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EAGrB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAMrC;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,SAAS,CAAkD;IAEnE;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,sBAAsB;IAO5C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,sBAAsB;IAgCjE;;;;;;;OAOG;IACH,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAIhC;;;;;;;OAOG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAIhC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,kBAAkB,GAAG,sBAAsB,GAAG,IAAI;IAkBtE;;;;;OAKG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAItD;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAO1D;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAMtD;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAStF;;;;;;;OAOG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI;IAUhC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAmB/D;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM;IAiCvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAa3B"}