crewly 1.6.4 → 1.6.5

package/dist/backend/backend/src/services/orchestrator/onboarding/materialize-team.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Materialize-Team Logic (Onboarding v3, v0)
+ *
+ * v0 stub: writes a minimal team `config.json` under `<teamsDir>/<id>/`
+ * and flips a project `onboardingComplete` flag. Real provisioning
+ * (template-engine wiring, agent-soul generation, system-prompt
+ * personalisation) lands Wed–Fri — Sam's brief explicitly says a
+ * "logs + flips flag" stub is acceptable for the Mon 5/4 EOD demo.
+ *
+ * The function is async + injection-friendly: callers pass a
+ * `teamsDir`, a `projectFlagPath`, a UUID generator, and a clock — so
+ * tests exercise the real write path with tmp dirs and deterministic
+ * IDs.
+ *
+ * Wired downstream: when this module is upgraded post-Mon, swap the
+ * inline write for a delegation to
+ * `backend/src/services/onboarding/onboarding-provision.service.ts`
+ * (it already provisions teams via TemplateService — see that file's
+ * `provisionFromOnboarding`).
+ *
+ * @module services/orchestrator/onboarding/materialize-team
+ */
+import type { TeamRecommendation } from './recommend-team.js';
+/**
+ * Side-effects the materialize step needs. Injected so tests can run
+ * against a tmp dir without touching the real `~/.crewly` tree.
+ */
+export interface MaterializeOptions {
+    /** Root teams directory (e.g. `~/.crewly/teams`). */
+    readonly teamsDir: string;
+    /** File path for the project onboarding-complete flag. */
+    readonly projectFlagPath: string;
+    /** UUID generator — defaults to {@link crypto.randomUUID} when omitted. */
+    readonly uuid?: () => string;
+    /** Clock — defaults to `() => new Date()` when omitted. */
+    readonly now?: () => Date;
+    /**
+     * Optional logger sink. When provided, the function writes the
+     * Mon-EOD-stub log lines through it (so tests can assert).
+     */
+    readonly log?: (message: string) => void;
+}
+/**
+ * Outcome of a successful materialize call.
+ */
+export interface MaterializeResult {
+    /** Newly-generated team ID (UUID). */
+    readonly teamId: string;
+    /** Absolute path to the team's `config.json`. */
+    readonly teamConfigPath: string;
+    /**
+     * Always `true` for a successful call — mirrors the brief's spec:
+     * "flips `onboardingComplete = true`".
+     */
+    readonly onboardingComplete: true;
+    /** Echo of the recommendation that was materialized (for orc to summarise back to the user). */
+    readonly recommendation: TeamRecommendation;
+    /**
+     * Where the project flag was persisted. The flag is a tiny JSON file
+     * (`{ onboardingComplete: true, completedAt }`).
+     */
+    readonly projectFlagPath: string;
+}
+/**
+ * Materialize a {@link TeamRecommendation} into a team config file +
+ * project onboarding-complete flag.
+ *
+ * v0 (Mon 5/4 EOD) writes a minimal config:
+ * ```json
+ * {
+ *   "id":   "<uuid>",
+ *   "name": "<recommendation.templateId> Team",
+ *   "createdAt": "...",
+ *   "createdBy": "onboarding-v3",
+ *   "templateId": "...",
+ *   "members": [ ... ]
+ * }
+ * ```
+ * No agent-soul personalisation, no project linkage, no goals.md
+ * generation — those land Wed–Fri when this calls into
+ * `onboarding-provision.service.ts`.
+ *
+ * @param recommendation - Output of {@link recommendTeam} that the user confirmed.
+ * @param opts - Side-effect injection (teamsDir, projectFlagPath, etc.).
+ * @returns The team ID + config path + flag-path on success.
+ * @throws If the team config write fails (filesystem error). Caller is
+ *         expected to surface a brief, honest error to the user
+ *         ("I couldn't create the team — error: …") rather than retry
+ *         silently.
+ *
+ * @example
+ * ```ts
+ * import { getCrewlyHomePath } from '../../core/crewly-home.utils.js';
+ *
+ * const crewlyHome = getCrewlyHomePath(); // honours CREWLY_HOME env override
+ * const result = await materializeTeam(rec, {
+ *   teamsDir: path.join(crewlyHome, 'teams'),
+ *   projectFlagPath: path.join(crewlyHome, 'onboarding-complete.json'),
+ * });
+ * console.log(result.teamId, '→', result.teamConfigPath);
+ * ```
+ *
+ * Do NOT inline `path.join(os.homedir(), '.crewly/teams')` — that
+ * ignores CREWLY_HOME and breaks ESTestNode + dry-run-kit isolation
+ * (see crewly-home.utils.ts for context).
+ */
+export declare function materializeTeam(recommendation: TeamRecommendation, opts: MaterializeOptions): Promise<MaterializeResult>;
+//# sourceMappingURL=materialize-team.d.ts.map

package/dist/backend/backend/src/services/orchestrator/onboarding/materialize-team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-team.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/orchestrator/onboarding/materialize-team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAClC,gGAAgG;IAChG,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,kBAAkB,EAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAqC5B"}

package/dist/backend/backend/src/services/orchestrator/onboarding/materialize-team.js

@@ -0,0 +1,165 @@
+/**
+ * Materialize-Team Logic (Onboarding v3, v0)
+ *
+ * v0 stub: writes a minimal team `config.json` under `<teamsDir>/<id>/`
+ * and flips a project `onboardingComplete` flag. Real provisioning
+ * (template-engine wiring, agent-soul generation, system-prompt
+ * personalisation) lands Wed–Fri — Sam's brief explicitly says a
+ * "logs + flips flag" stub is acceptable for the Mon 5/4 EOD demo.
+ *
+ * The function is async + injection-friendly: callers pass a
+ * `teamsDir`, a `projectFlagPath`, a UUID generator, and a clock — so
+ * tests exercise the real write path with tmp dirs and deterministic
+ * IDs.
+ *
+ * Wired downstream: when this module is upgraded post-Mon, swap the
+ * inline write for a delegation to
+ * `backend/src/services/onboarding/onboarding-provision.service.ts`
+ * (it already provisions teams via TemplateService — see that file's
+ * `provisionFromOnboarding`).
+ *
+ * @module services/orchestrator/onboarding/materialize-team
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Materialize a {@link TeamRecommendation} into a team config file +
+ * project onboarding-complete flag.
+ *
+ * v0 (Mon 5/4 EOD) writes a minimal config:
+ * ```json
+ * {
+ *   "id":   "<uuid>",
+ *   "name": "<recommendation.templateId> Team",
+ *   "createdAt": "...",
+ *   "createdBy": "onboarding-v3",
+ *   "templateId": "...",
+ *   "members": [ ... ]
+ * }
+ * ```
+ * No agent-soul personalisation, no project linkage, no goals.md
+ * generation — those land Wed–Fri when this calls into
+ * `onboarding-provision.service.ts`.
+ *
+ * @param recommendation - Output of {@link recommendTeam} that the user confirmed.
+ * @param opts - Side-effect injection (teamsDir, projectFlagPath, etc.).
+ * @returns The team ID + config path + flag-path on success.
+ * @throws If the team config write fails (filesystem error). Caller is
+ *         expected to surface a brief, honest error to the user
+ *         ("I couldn't create the team — error: …") rather than retry
+ *         silently.
+ *
+ * @example
+ * ```ts
+ * import { getCrewlyHomePath } from '../../core/crewly-home.utils.js';
+ *
+ * const crewlyHome = getCrewlyHomePath(); // honours CREWLY_HOME env override
+ * const result = await materializeTeam(rec, {
+ *   teamsDir: path.join(crewlyHome, 'teams'),
+ *   projectFlagPath: path.join(crewlyHome, 'onboarding-complete.json'),
+ * });
+ * console.log(result.teamId, '→', result.teamConfigPath);
+ * ```
+ *
+ * Do NOT inline `path.join(os.homedir(), '.crewly/teams')` — that
+ * ignores CREWLY_HOME and breaks ESTestNode + dry-run-kit isolation
+ * (see crewly-home.utils.ts for context).
+ */
+export async function materializeTeam(recommendation, opts) {
+    const uuid = opts.uuid ?? defaultUuid;
+    const now = opts.now ?? defaultNow;
+    const log = opts.log ?? noopLog;
+    const teamId = uuid();
+    const teamDir = path.join(opts.teamsDir, teamId);
+    const teamConfigPath = path.join(teamDir, 'config.json');
+    const createdAt = now().toISOString();
+    log(`[materialize-team] would materialize team for template "${recommendation.templateId}" with ${recommendation.agents.length} agents (id=${teamId})`);
+    // 1. Write the team config.
+    const config = buildTeamConfig(recommendation, teamId, createdAt);
+    await fs.mkdir(teamDir, { recursive: true });
+    await fs.writeFile(teamConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    // 2. Flip the project onboarding-complete flag.
+    const flag = { onboardingComplete: true, completedAt: createdAt };
+    await fs.mkdir(path.dirname(opts.projectFlagPath), { recursive: true });
+    await fs.writeFile(opts.projectFlagPath, JSON.stringify(flag, null, 2) + '\n', 'utf8');
+    log(`[materialize-team] flipped onboardingComplete = true at ${opts.projectFlagPath}`);
+    return {
+        teamId,
+        teamConfigPath,
+        onboardingComplete: true,
+        recommendation,
+        projectFlagPath: opts.projectFlagPath,
+    };
+}
+// =============================================================================
+// Internals
+// =============================================================================
+/**
+ * Build the minimal v0 team config. Members are derived 1:1 from the
+ * recommendation's agents list.
+ */
+function buildTeamConfig(rec, teamId, createdAt) {
+    return {
+        id: teamId,
+        name: humanizeTemplateName(rec.templateId),
+        description: rec.reasoning,
+        templateId: rec.templateId,
+        createdAt,
+        createdBy: 'onboarding-v3',
+        onboardingSource: rec.source,
+        members: rec.agents.map((a, idx) => ({
+            id: `${teamId}-${idx}`,
+            name: humanizeRoleName(a.role),
+            role: a.role,
+            responsibilities: a.responsibilities,
+            skillIds: [...a.skillIds],
+            systemPrompt: '',
+            agentStatus: 'inactive',
+            workingStatus: 'idle',
+        })),
+    };
+}
+/**
+ * Convert a kebab-case template id → human team name
+ * (`"dtc-viral-content-team"` → `"Dtc Viral Content Team"`). The full
+ * personalisation pass happens post-Mon when we wire into
+ * `onboarding-provision.service.ts` — that service already builds
+ * proper names.
+ */
+function humanizeTemplateName(templateId) {
+    return templateId
+        .split('-')
+        .map((p) => (p.length ? p[0].toUpperCase() + p.slice(1) : p))
+        .join(' ');
+}
+/**
+ * Convert a kebab-case role → human display name.
+ */
+function humanizeRoleName(role) {
+    return role
+        .split('-')
+        .map((p) => (p.length ? p[0].toUpperCase() + p.slice(1) : p))
+        .join(' ');
+}
+/**
+ * Default UUID generator. Uses Node's `crypto.randomUUID` so we don't
+ * pull in a dep, and so the output is deterministic-shaped.
+ */
+function defaultUuid() {
+    // Lazy require to keep the import surface minimal and avoid loading
+    // `node:crypto` at module load.
+    const { randomUUID } = require('node:crypto');
+    return randomUUID();
+}
+/** Default clock — wall-clock time. */
+function defaultNow() {
+    return new Date();
+}
+/** Default log sink — drops the message on the floor. */
+function noopLog(_message) {
+    /* intentional no-op */
+}
+//# sourceMappingURL=materialize-team.js.map

package/dist/backend/backend/src/services/orchestrator/onboarding/materialize-team.js.map

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

package/dist/backend/backend/src/services/orchestrator/onboarding/recommend-team.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Recommend-Team Logic (Onboarding v3, v0)
+ *
+ * Pure function: turns a business-context payload (collected during the
+ * onboarding conversation) into a concrete team recommendation
+ * (template + agents + responsibilities).
+ *
+ * v0 strategy: 5 hardcoded heuristic mappings that cover the ~80% case
+ * Steve and Sam expect to see during the Mon 5/4 EOD demo, plus a
+ * generic 2-agent fallback for everything else. Real RAG over Mia's
+ * spec v3 + doc 69 + the live template registry lands Wed–Fri.
+ *
+ * Importantly, the function is **pure** (no FS, no API, no clock) —
+ * tests exercise the mapping logic directly without mocks.
+ *
+ * @module services/orchestrator/onboarding/recommend-team
+ */
+/**
+ * Feasibility tier for a single user-named task. Mirrors the four tiers
+ * the system prompt requires orc to use literally.
+ */
+export type FeasibilityTier = 'yes-today' | 'collaborative' | 'roadmap' | 'out-of-scope';
+/**
+ * Scale buckets — the conversation captures one of these in phase 2.
+ */
+export type BusinessScale = 'solo' | 'small-team' | 'company';
+/**
+ * One task the user named, with the feasibility verdict orc reached
+ * during phase 3.
+ */
+export interface NamedTask {
+    /** Free-text task name as the user said it. */
+    readonly name: string;
+    /** Feasibility verdict orc decided on. */
+    readonly tier: FeasibilityTier;
+}
+/**
+ * Business context collected by phases 1–3 of the onboarding flow.
+ * Passed to {@link recommendTeam} to produce the proposal.
+ */
+export interface BusinessContext {
+    /** Free-text industry / domain (e.g. "e-commerce skincare on Shopify"). */
+    readonly industry: string;
+    /** Coarse team-size bucket. */
+    readonly scale: BusinessScale;
+    /** Tasks the user named, with orc's feasibility verdict per task. */
+    readonly tasks: readonly NamedTask[];
+}
+/**
+ * One agent the recommendation proposes.
+ */
+export interface RecommendedAgent {
+    /** Logical role (e.g. "content-drafter", "support-triage"). */
+    readonly role: string;
+    /** One-sentence responsibility blurb shown to the user during phase 4. */
+    readonly responsibilities: string;
+    /** Skills the agent will be given. */
+    readonly skillIds: readonly string[];
+}
+/**
+ * The recommendation returned to orc and shown to the user before
+ * confirmation.
+ */
+export interface TeamRecommendation {
+    /** Template ID from `config/templates/*.json`. */
+    readonly templateId: string;
+    /** 2–4 agents, each with role + responsibilities + skills. */
+    readonly agents: readonly RecommendedAgent[];
+    /** Short rationale string ("why this team for you"). */
+    readonly reasoning: string;
+    /** Which mapping fired (`"hardcoded:<key>"` or `"fallback"`). */
+    readonly source: string;
+}
+/**
+ * Map a {@link BusinessContext} to a {@link TeamRecommendation}.
+ *
+ * Strategy (v0):
+ *   1. Score every hardcoded mapping by counting keyword hits across
+ *      `industry` + each task name.
+ *   2. Highest-scoring mapping wins (ties broken by declaration order).
+ *   3. If no mapping scores ≥1, fire the generic 2-agent fallback.
+ *
+ * The function never throws — invalid input degrades to the fallback so
+ * the conversation can keep moving even if discovery captured nothing
+ * useful.
+ *
+ * @param ctx - Business context collected during phases 1–3.
+ * @returns A team recommendation ready for phase 4.
+ *
+ * @example
+ * ```ts
+ * recommendTeam({
+ *   industry: 'small Shopify skincare shop',
+ *   scale: 'solo',
+ *   tasks: [
+ *     { name: 'weekly blog content', tier: 'yes-today' },
+ *     { name: 'customer support replies', tier: 'yes-today' },
+ *   ],
+ * });
+ * // → templateId: 'dtc-viral-content-team', 2 agents, …
+ * ```
+ */
+export declare function recommendTeam(ctx: BusinessContext): TeamRecommendation;
+/**
+ * Exposed for test introspection — the count is asserted against the
+ * spec ("5 hardcoded mappings cover 80% of users").
+ */
+export declare const HARDCODED_MAPPING_COUNT: number;
+/**
+ * Exposed for test introspection — list of mapping keys, useful for
+ * asserting coverage without opening the array.
+ */
+export declare const HARDCODED_MAPPING_KEYS: readonly string[];
+//# sourceMappingURL=recommend-team.d.ts.map

package/dist/backend/backend/src/services/orchestrator/onboarding/recommend-team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend-team.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/orchestrator/onboarding/recommend-team.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,eAAe,GACf,SAAS,GACT,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA4OD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAmBtE;AAoED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAA4B,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAEnD,CAAC"}