crewly 1.2.3 → 1.2.6

package/dist/backend/backend/src/types/team-template.types.js

@@ -0,0 +1,139 @@
+/**
+ * Team Template Types
+ *
+ * Defines the structure for team templates — reusable team recipes
+ * that include roles, hierarchy configuration, and verification pipelines.
+ * Templates are stored in config/templates/ and loaded by TemplateService.
+ *
+ * @module types/team-template
+ */
+export const TEMPLATE_CATEGORIES = [
+    'development',
+    'content',
+    'research',
+    'operations',
+    'custom',
+];
+export const VERIFICATION_METHODS = [
+    'quality_gates',
+    'e2e_test',
+    'code_review',
+    'browser_test',
+    'screenshot_review',
+    'gemini_vision',
+    'content_check',
+    'fact_check',
+    'source_verify',
+    'data_validate',
+    'manual_review',
+    'custom_script',
+];
+// =============================================================================
+// Validators
+// =============================================================================
+/**
+ * Check if a value is a valid TemplateCategory.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidTemplateCategory(value) {
+    return typeof value === 'string' && TEMPLATE_CATEGORIES.includes(value);
+}
+/**
+ * Check if a value is a valid VerificationMethod.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidVerificationMethod(value) {
+    return typeof value === 'string' && VERIFICATION_METHODS.includes(value);
+}
+/**
+ * Validate a VerificationStep object.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidVerificationStep(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const step = value;
+    return (typeof step.id === 'string' && step.id.length > 0 &&
+        typeof step.name === 'string' && step.name.length > 0 &&
+        typeof step.description === 'string' &&
+        isValidVerificationMethod(step.method) &&
+        typeof step.critical === 'boolean' &&
+        step.config !== null && typeof step.config === 'object');
+}
+/**
+ * Validate a VerificationPipeline object.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidVerificationPipeline(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const pipeline = value;
+    if (typeof pipeline.name !== 'string' || pipeline.name.length === 0)
+        return false;
+    if (!Array.isArray(pipeline.steps) || pipeline.steps.length === 0)
+        return false;
+    if (!['all', 'majority', 'critical_only'].includes(pipeline.passPolicy))
+        return false;
+    if (typeof pipeline.maxRetries !== 'number' || pipeline.maxRetries < 0)
+        return false;
+    return pipeline.steps.every((s) => isValidVerificationStep(s));
+}
+/**
+ * Validate a TemplateRole object.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidTemplateRole(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const role = value;
+    return (typeof role.role === 'string' && role.role.length > 0 &&
+        typeof role.label === 'string' && role.label.length > 0 &&
+        typeof role.defaultName === 'string' && role.defaultName.length > 0 &&
+        typeof role.count === 'number' && role.count >= 1 &&
+        typeof role.hierarchyLevel === 'number' && role.hierarchyLevel >= 0 &&
+        typeof role.canDelegate === 'boolean' &&
+        Array.isArray(role.defaultSkills));
+}
+/**
+ * Validate a TeamTemplate object.
+ *
+ * @param value - Value to check
+ * @returns True if valid
+ */
+export function isValidTeamTemplate(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const t = value;
+    if (typeof t.id !== 'string' || t.id.length === 0)
+        return false;
+    if (typeof t.name !== 'string' || t.name.length === 0)
+        return false;
+    if (typeof t.description !== 'string')
+        return false;
+    if (!isValidTemplateCategory(t.category))
+        return false;
+    if (typeof t.version !== 'string')
+        return false;
+    if (typeof t.hierarchical !== 'boolean')
+        return false;
+    if (!Array.isArray(t.roles) || t.roles.length === 0)
+        return false;
+    if (!t.roles.every((r) => isValidTemplateRole(r)))
+        return false;
+    if (!['claude-code', 'gemini-cli', 'codex-cli', 'crewly-agent'].includes(t.defaultRuntime))
+        return false;
+    if (!isValidVerificationPipeline(t.verificationPipeline))
+        return false;
+    return true;
+}
+//# sourceMappingURL=team-template.types.js.map

package/dist/backend/backend/src/types/team-template.types.js.map

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

package/dist/backend/backend/src/utils/async-handler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared async handler for Express route handlers.
+ *
+ * Wraps an async route handler with a standard try/catch that returns
+ * a consistent JSON error response on unhandled exceptions.
+ *
+ * @module utils/async-handler
+ */
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * Wraps an async route handler with error catching.
+ *
+ * Catches unhandled errors and either forwards them to Express error middleware
+ * (if next is available) or responds with a 500 JSON error.
+ *
+ * @param fn - The async handler function to wrap
+ * @returns A wrapped handler that catches errors
+ */
+export declare function asyncHandler(fn: (req: Request, res: Response, next: NextFunction) => Promise<void>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+//# sourceMappingURL=async-handler.d.ts.map

package/dist/backend/backend/src/utils/async-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handler.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/async-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,IACpF,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E"}

package/dist/backend/backend/src/utils/async-handler.js

@@ -0,0 +1,29 @@
+/**
+ * Shared async handler for Express route handlers.
+ *
+ * Wraps an async route handler with a standard try/catch that returns
+ * a consistent JSON error response on unhandled exceptions.
+ *
+ * @module utils/async-handler
+ */
+/**
+ * Wraps an async route handler with error catching.
+ *
+ * Catches unhandled errors and either forwards them to Express error middleware
+ * (if next is available) or responds with a 500 JSON error.
+ *
+ * @param fn - The async handler function to wrap
+ * @returns A wrapped handler that catches errors
+ */
+export function asyncHandler(fn) {
+    return async (req, res, next) => {
+        try {
+            await fn(req, res, next);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            res.status(500).json({ success: false, error: msg });
+        }
+    };
+}
+//# sourceMappingURL=async-handler.js.map

package/dist/backend/backend/src/utils/async-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handler.js","sourceRoot":"","sources":["../../../../../backend/src/utils/async-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,EAAsE;IAClG,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAiB,EAAE;QAC/E,IAAI,CAAC;YACJ,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}

package/dist/backend/backend/src/utils/defaultPrompts.d.ts

@@ -1,5 +1,5 @@
-import { TeamMember } from '../types/index.js';
-export declare const DEFAULT_SYSTEM_PROMPTS: Record<TeamMember['role'], string>;
-export declare function getDefaultPrompt(role: TeamMember['role']): string;
-export declare function getDefaultTeamMemberName(role: TeamMember['role'], index?: number): string;
+import { TeamMemberRole } from '../types/index.js';
+export declare const DEFAULT_SYSTEM_PROMPTS: Record<TeamMemberRole, string>;
+export declare function getDefaultPrompt(role: TeamMemberRole): string;
+export declare function getDefaultTeamMemberName(role: TeamMemberRole, index?: number): string;
 //# sourceMappingURL=defaultPrompts.d.ts.map

package/dist/backend/backend/src/utils/defaultPrompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultPrompts.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/defaultPrompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAiRrE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAEjE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAqB5F"}
+{"version":3,"file":"defaultPrompts.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/defaultPrompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAiSjE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE7D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAsBxF"}

package/dist/backend/backend/src/utils/defaultPrompts.js

@@ -13,6 +13,21 @@ Communication style:
 - Ask clarifying questions when requirements are unclear
 - Provide regular status updates to stakeholders
 - Focus on maintaining team productivity and morale`,
+    'team-leader': `You are an AI Team Leader responsible for managing a sub-team of workers.
+
+Your responsibilities:
+- Decompose high-level goals into specific worker tasks
+- Delegate tasks to appropriate workers based on role and workload
+- Monitor worker progress and handle blockers
+- Verify completed work meets quality standards
+- Aggregate results and report up to the Orchestrator
+- Handle worker failures with retries or reassignment
+
+Communication style:
+- Give clear, actionable task instructions to workers
+- Provide constructive feedback when reviewing outputs
+- Escalate to Orchestrator when issues cannot be resolved locally
+- Report progress and results concisely`,
     tpm: `You are an AI Technical Product Manager (TPM) responsible for scoping projects and translating business logic into technical requirements.
 
 Your responsibilities:
@@ -264,6 +279,7 @@ export function getDefaultPrompt(role) {
 export function getDefaultTeamMemberName(role, index = 0) {
     const roleNames = {
         orchestrator: 'Orchestrator',
+        'team-leader': 'Team Leader',
         tpm: 'Technical Product Manager',
         architect: 'Architect',
         pgm: 'Program Manager',

package/dist/backend/backend/src/utils/defaultPrompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultPrompts.js","sourceRoot":"","sources":["../../../../../backend/src/utils/defaultPrompts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE,YAAY,EAAE;;;;;;;;;;;;;oDAaoC;IAElD,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;6DAsBsD;IAE3D,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;2DAsBoD;IAEzD,SAAS,EAAE;;;;;;;;;;;;;2CAa8B;IAEzC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;2DAmBmC;IAEzD,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;yDAmBkC;IAEvD,EAAE,EAAE;;;;;;;;;;;;;0CAaoC;IAExC,MAAM,EAAE;;;;;;;;;;;;;8CAaoC;IAE5C,QAAQ,EAAE;;;;;;;;;;;;;6CAaiC;IAE3C,SAAS,EAAE;;;;;;;;;;;;;;;;;;;8DAmBiD;IAE5D,eAAe,EAAE;;;;;;;;;;;;;;;;;;;wDAmBqC;IAEtD,aAAa,EAAE;;;;;;;;;;;;;;;;;;;6CAmB4B;IAE3C,iBAAiB,EAAE;;;;;;;;;;;;;0CAaqB;IAExC,KAAK,EAAE;;;;;;;;;;;;;wDAa+C;IAEtD,OAAO,EAAE;;;;;;;;;;;;;uDAa4C;CACtD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAwB,EAAE,QAAgB,CAAC;IAClF,MAAM,SAAS,GAAuC;QACpD,YAAY,EAAE,cAAc;QAC5B,GAAG,EAAE,2BAA2B;QAChC,SAAS,EAAE,WAAW;QACtB,GAAG,EAAE,iBAAiB;QACtB,SAAS,EAAE,WAAW;QACtB,oBAAoB,EAAE,oBAAoB;QAC1C,mBAAmB,EAAE,mBAAmB;QACxC,eAAe,EAAE,sBAAsB;QACvC,EAAE,EAAE,aAAa;QACjB,aAAa,EAAE,aAAa;QAC5B,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,UAAU;QACpB,iBAAiB,EAAE,iBAAiB;QACpC,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IAEF,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"defaultPrompts.js","sourceRoot":"","sources":["../../../../../backend/src/utils/defaultPrompts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,YAAY,EAAE;;;;;;;;;;;;;oDAaoC;IAElD,aAAa,EAAE;;;;;;;;;;;;;;wCAcuB;IAEtC,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;6DAsBsD;IAE3D,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;2DAsBoD;IAEzD,SAAS,EAAE;;;;;;;;;;;;;2CAa8B;IAEzC,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;2DAmBmC;IAEzD,mBAAmB,EAAE;;;;;;;;;;;;;;;;;;;yDAmBkC;IAEvD,EAAE,EAAE;;;;;;;;;;;;;0CAaoC;IAExC,MAAM,EAAE;;;;;;;;;;;;;8CAaoC;IAE5C,QAAQ,EAAE;;;;;;;;;;;;;6CAaiC;IAE3C,SAAS,EAAE;;;;;;;;;;;;;;;;;;;8DAmBiD;IAE5D,eAAe,EAAE;;;;;;;;;;;;;;;;;;;wDAmBqC;IAEtD,aAAa,EAAE;;;;;;;;;;;;;;;;;;;6CAmB4B;IAE3C,iBAAiB,EAAE;;;;;;;;;;;;;0CAaqB;IAExC,KAAK,EAAE;;;;;;;;;;;;;wDAa+C;IAEtD,OAAO,EAAE;;;;;;;;;;;;;uDAa4C;CACtD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAoB;IACnD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAoB,EAAE,QAAgB,CAAC;IAC9E,MAAM,SAAS,GAAmC;QAChD,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE,aAAa;QAC5B,GAAG,EAAE,2BAA2B;QAChC,SAAS,EAAE,WAAW;QACtB,GAAG,EAAE,iBAAiB;QACtB,SAAS,EAAE,WAAW;QACtB,oBAAoB,EAAE,oBAAoB;QAC1C,mBAAmB,EAAE,mBAAmB;QACxC,eAAe,EAAE,sBAAsB;QACvC,EAAE,EAAE,aAAa;QACjB,aAAa,EAAE,aAAa;QAC5B,MAAM,EAAE,eAAe;QACvB,QAAQ,EAAE,UAAU;QACpB,iBAAiB,EAAE,iBAAiB;QACpC,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IAEF,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/backend/backend/src/utils/gemini-trusted-folders.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Gemini CLI Trusted Folders Utility
+ *
+ * Provides a standalone function to add folder paths to
+ * ~/.gemini/trustedFolders.json so that Gemini CLI does not
+ * show an interactive trust prompt when launched in those directories.
+ *
+ * @module utils/gemini-trusted-folders
+ */
+/**
+ * Minimal logger interface for trusted-folder operations.
+ * Compatible with ComponentLogger from LoggerService.
+ */
+export interface TrustedFoldersLogger {
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Return the default path to the Gemini trusted folders JSON file.
+ */
+export declare function getDefaultTrustedFoldersPath(): string;
+/**
+ * Add one or more folder paths to the Gemini trusted folders JSON file.
+ *
+ * The function is idempotent — paths that are already present are skipped.
+ * The file and its parent directory are created if they do not exist.
+ * Errors are caught and logged (non-fatal) so callers are never blocked.
+ *
+ * @param paths - Absolute or resolvable folder paths to trust
+ * @param logger - Optional logger for diagnostics; if omitted, failures are silent
+ * @param trustedFoldersPath - Override path for testing; defaults to ~/.gemini/trustedFolders.json
+ * @returns true if any paths were added, false if nothing changed or an error occurred
+ */
+export declare function addGeminiTrustedFolders(paths: string[], logger?: TrustedFoldersLogger, trustedFoldersPath?: string): Promise<boolean>;
+/**
+ * Build a list of paths that should be trusted for a given project path.
+ * Includes the project path itself and its parent directory.
+ *
+ * @param projectPath - Absolute path to the project
+ * @returns Array of paths to add to trusted folders
+ */
+export declare function getProjectTrustPaths(projectPath: string): string[];
+//# sourceMappingURL=gemini-trusted-folders.d.ts.map

package/dist/backend/backend/src/utils/gemini-trusted-folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-trusted-folders.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/gemini-trusted-folders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5D;AAKD;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC5C,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,CAAC,EAAE,oBAAoB,EAC7B,kBAAkB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC,CAgDlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlE"}

package/dist/backend/backend/src/utils/gemini-trusted-folders.js

@@ -0,0 +1,94 @@
+/**
+ * Gemini CLI Trusted Folders Utility
+ *
+ * Provides a standalone function to add folder paths to
+ * ~/.gemini/trustedFolders.json so that Gemini CLI does not
+ * show an interactive trust prompt when launched in those directories.
+ *
+ * @module utils/gemini-trusted-folders
+ */
+import { promises as fsPromises } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+/** Sentinel value used by Gemini CLI to mark a folder as trusted. */
+const TRUST_VALUE = 'TRUST_FOLDER';
+/**
+ * Return the default path to the Gemini trusted folders JSON file.
+ */
+export function getDefaultTrustedFoldersPath() {
+    return path.join(os.homedir(), '.gemini', 'trustedFolders.json');
+}
+/**
+ * Add one or more folder paths to the Gemini trusted folders JSON file.
+ *
+ * The function is idempotent — paths that are already present are skipped.
+ * The file and its parent directory are created if they do not exist.
+ * Errors are caught and logged (non-fatal) so callers are never blocked.
+ *
+ * @param paths - Absolute or resolvable folder paths to trust
+ * @param logger - Optional logger for diagnostics; if omitted, failures are silent
+ * @param trustedFoldersPath - Override path for testing; defaults to ~/.gemini/trustedFolders.json
+ * @returns true if any paths were added, false if nothing changed or an error occurred
+ */
+export async function addGeminiTrustedFolders(paths, logger, trustedFoldersPath) {
+    if (paths.length === 0)
+        return false;
+    const filePath = trustedFoldersPath ?? getDefaultTrustedFoldersPath();
+    const normalizedPaths = [...new Set(paths.map((p) => path.resolve(p)))];
+    try {
+        let trustedFolders = {};
+        try {
+            const raw = await fsPromises.readFile(filePath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                trustedFolders = parsed;
+            }
+        }
+        catch (readError) {
+            // Missing file is expected on first run; malformed content is reset.
+            if (readError?.code !== 'ENOENT') {
+                logger?.warn('Failed to read Gemini trusted folders, resetting file', {
+                    trustedFoldersPath: filePath,
+                    error: readError instanceof Error ? readError.message : String(readError),
+                });
+            }
+        }
+        let changed = false;
+        for (const folderPath of normalizedPaths) {
+            if (trustedFolders[folderPath] !== TRUST_VALUE) {
+                trustedFolders[folderPath] = TRUST_VALUE;
+                changed = true;
+            }
+        }
+        if (!changed)
+            return false;
+        await fsPromises.mkdir(path.dirname(filePath), { recursive: true });
+        await fsPromises.writeFile(filePath, `${JSON.stringify(trustedFolders, null, 2)}\n`, 'utf8');
+        logger?.info('Gemini trusted folders updated', {
+            trustedFoldersPath: filePath,
+            addedPaths: normalizedPaths,
+        });
+        return true;
+    }
+    catch (error) {
+        logger?.warn('Failed to update Gemini trusted folders (non-fatal)', {
+            trustedFoldersPath: filePath,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+}
+/**
+ * Build a list of paths that should be trusted for a given project path.
+ * Includes the project path itself and its parent directory.
+ *
+ * @param projectPath - Absolute path to the project
+ * @returns Array of paths to add to trusted folders
+ */
+export function getProjectTrustPaths(projectPath) {
+    const resolved = path.resolve(projectPath);
+    const parentDir = path.dirname(resolved);
+    // Deduplicate in case projectPath is at the filesystem root
+    return [...new Set([resolved, parentDir])];
+}
+//# sourceMappingURL=gemini-trusted-folders.js.map

package/dist/backend/backend/src/utils/gemini-trusted-folders.js.map

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

package/dist/backend/backend/src/utils/message-serializer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Serialization and deserialization for hierarchy message types.
+ *
+ * Converts structured message objects to markdown for PTY delivery,
+ * and parses markdown back into typed objects on the agent side.
+ *
+ * Format uses header blocks with bracketed type identifiers:
+ *   [TASK ASSIGNMENT], [STATUS REPORT], [VERIFICATION REQUEST], [VERIFICATION RESULT]
+ */
+import type { TaskAssignment, StatusReport, VerificationRequest, VerificationResult } from '../types/hierarchy-message.types.js';
+/**
+ * Serialize a TaskAssignment to markdown for PTY delivery.
+ *
+ * @param msg - The task assignment message
+ * @returns Markdown-formatted string with [TASK ASSIGNMENT] header
+ */
+export declare function serializeTaskAssignment(msg: TaskAssignment): string;
+/**
+ * Serialize a StatusReport to markdown for PTY delivery.
+ *
+ * @param msg - The status report message
+ * @returns Markdown-formatted string with [STATUS REPORT] header
+ */
+export declare function serializeStatusReport(msg: StatusReport): string;
+/**
+ * Serialize a VerificationRequest to markdown for PTY delivery.
+ *
+ * @param msg - The verification request message
+ * @returns Markdown-formatted string with [VERIFICATION REQUEST] header
+ */
+export declare function serializeVerificationRequest(msg: VerificationRequest): string;
+/**
+ * Serialize a VerificationResult to markdown for PTY delivery.
+ *
+ * @param msg - The verification result message
+ * @returns Markdown-formatted string with [VERIFICATION RESULT] header
+ */
+export declare function serializeVerificationResult(msg: VerificationResult): string;
+/**
+ * Parse a TaskAssignment from serialized markdown.
+ *
+ * @param text - Markdown text with [TASK ASSIGNMENT] header
+ * @returns Parsed TaskAssignment or null if parsing fails
+ */
+export declare function parseTaskAssignment(text: string): TaskAssignment | null;
+/**
+ * Parse a StatusReport from serialized markdown.
+ *
+ * @param text - Markdown text with [STATUS REPORT] header
+ * @returns Parsed StatusReport or null if parsing fails
+ */
+export declare function parseStatusReport(text: string): StatusReport | null;
+/**
+ * Parse a VerificationRequest from serialized markdown.
+ *
+ * @param text - Markdown text with [VERIFICATION REQUEST] header
+ * @returns Parsed VerificationRequest or null if parsing fails
+ */
+export declare function parseVerificationRequest(text: string): VerificationRequest | null;
+/**
+ * Parse a VerificationResult from serialized markdown.
+ *
+ * @param text - Markdown text with [VERIFICATION RESULT] header
+ * @returns Parsed VerificationResult or null if parsing fails
+ */
+export declare function parseVerificationResult(text: string): VerificationResult | null;
+/**
+ * Detect the message type from serialized markdown text.
+ *
+ * @param text - Markdown text to analyze
+ * @returns The detected message type, or null if not recognized
+ */
+export declare function detectMessageType(text: string): TaskAssignment['type'] | StatusReport['type'] | VerificationRequest['type'] | VerificationResult['type'] | null;
+//# sourceMappingURL=message-serializer.d.ts.map

package/dist/backend/backend/src/utils/message-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-serializer.d.ts","sourceRoot":"","sources":["../../../../../backend/src/utils/message-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,qCAAqC,CAAC;AAO7C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAmCnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CA6B/D;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAwB7E;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAe3E;AAuHD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAsCvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAkCnE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA2BjF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAsB/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAM/J"}