crewly 1.8.13 → 1.10.0

package/dist/backend/backend/src/services/v3/okr-cascade.service.js

@@ -0,0 +1,417 @@
+/**
+ * OKR Cascade Service
+ *
+ * Owns the decompose → propose → approve/reject workflow for the OKR cascade
+ * (company → team → project). A team-leader/PM agent drafts child OKRs as a
+ * PROPOSAL; the child Missions are persisted with
+ * `approval.state = 'pending_approval'` and are NOT cascade-active until the
+ * human owner approves. Rejection carries a required reason.
+ *
+ * This service is the SINGLE owner of `approval.state` transitions — the
+ * `updateMission` PUT route blocks direct `approval` writes so that all
+ * transitions flow through {@link OKRCascadeService.approveDecomposition} and
+ * {@link OKRCascadeService.rejectDecomposition} (spec §3.2/§3.3).
+ *
+ * FLAG (spec §2.5): the approval *workflow* (this service + its routes) is a
+ * plausible future move to `crewly-pro` as a gated governance feature. The
+ * approval *types* live in `mission.types.ts` and stay there; only this
+ * workflow layer would relocate. Do NOT split now.
+ *
+ * Persistence reuses the existing on-disk layout:
+ *   - Missions: `.crewly/missions/{id}.json`
+ *   - KRs:      `.crewly/missions/{id}/key-results/` (via {@link KRTrackingService})
+ *
+ * @module services/v3/okr-cascade.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { KRTrackingService } from './kr-tracking.service.js';
+import { createMission, validateCascadeLink, resolveMissionLevel, isMission, isValidProposalState, isValidProposalTransition, MISSION_LEVELS, MISSION_LEVEL_DEPTH, } from '../../types/v2/mission.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Workspace root folder for Crewly runtime state. */
+const CREWLY_HOME = '.crewly';
+/** Folder under {@link CREWLY_HOME} that holds one JSON file per Mission. */
+const MISSIONS_DIR = 'missions';
+/** Proposal state stamped on a freshly-proposed child mission. */
+const PROPOSED_STATE = 'pending_approval';
+/** Proposal state after a successful owner approval. */
+const APPROVED_STATE = 'approved';
+/** Proposal state after an owner rejection. */
+const REJECTED_STATE = 'rejected';
+/**
+ * State a corrupt/unrecognized persisted `approval.state` is normalized to on
+ * read. `rejected` is a recognized, INACTIVE, non-approvable state: a corrupt
+ * doc must NOT be trusted as cascade-active and must NOT be approvable directly
+ * (the only approve path is `pending_approval → approved`). See
+ * {@link OKRCascadeService.sanitizeMission}.
+ */
+const CORRUPT_APPROVAL_FALLBACK = REJECTED_STATE;
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Singleton service implementing the OKR decomposition / approval workflow.
+ */
+export class OKRCascadeService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('OKRCascade');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The shared {@link OKRCascadeService}
+     */
+    static getInstance() {
+        if (!OKRCascadeService.instance) {
+            OKRCascadeService.instance = new OKRCascadeService();
+        }
+        return OKRCascadeService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        OKRCascadeService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Draft a child OKR decomposition for a parent mission as a PROPOSAL.
+     *
+     * The parent must exist and be cascade-active (approval absent or
+     * `approval.state === 'approved'`). The child level is computed as exactly one
+     * tier below the parent; decomposing a `project`-level parent is rejected
+     * (there is no tier below project). Each child mission is created with
+     * `approval.state = 'pending_approval'` and is NOT active until the owner
+     * approves. Each child's Key Results are created via {@link KRTrackingService}
+     * (no duplicate KR persistence here).
+     *
+     * The decomposition is "fail before writing": EVERY child is fully validated
+     * (project-id presence + cascade-link adjacency/cycle) BEFORE any mission or
+     * KR is persisted, so a later invalid child never leaves an earlier child
+     * half-written to disk.
+     *
+     * @param parentId - ID of the parent mission to decompose
+     * @param input - The proposed child OKRs (objectives + KRs)
+     * @param proposedBy - Agent session that drafted the proposal
+     * @returns The parent id, resolved child level, and created child IDs
+     * @throws If the parent is missing, not approved, already at `project` level,
+     *   the input has no children, or a child fails cascade-link validation
+     *
+     * @example
+     * ```ts
+     * const result = await OKRCascadeService.getInstance().proposeDecomposition(
+     *   'co-1',
+     *   { children: [{ objective: 'Ship v2', currentStrategy: '...', successCriteria: [], keyResults: [] }] },
+     *   'team-leader-session',
+     * );
+     * ```
+     */
+    async proposeDecomposition(parentId, input, proposedBy) {
+        if (!input.children || input.children.length === 0) {
+            throw new Error('Decomposition requires at least one child OKR');
+        }
+        const all = await this.loadAllMissions();
+        const byId = new Map(all.map((m) => [m.id, m]));
+        const parent = byId.get(parentId);
+        if (!parent) {
+            throw new Error(`Parent mission ${parentId} does not exist`);
+        }
+        if (!this.isCascadeActive(parent)) {
+            throw new Error(`Parent mission ${parentId} is not approved; only approved missions can be decomposed`);
+        }
+        const parentLevel = this.resolveLevel(parent, byId);
+        const childLevel = this.nextLevel(parentLevel);
+        if (childLevel === null) {
+            throw new Error(`A ${parentLevel}-level mission is the bottom of the cascade and cannot be decomposed further`);
+        }
+        // ----- Pre-write validation pass (fail BEFORE any persist) -------------
+        // Build every child mission up-front and run the FULL cascade guard
+        // (project-id presence + validateCascadeLink) against the live tree plus
+        // the siblings already built in this same proposal. Only once ALL children
+        // pass do we persist anything — so a later invalid child can never leave an
+        // earlier child (or its KRs) on disk (transactional "all-or-nothing").
+        const now = new Date().toISOString();
+        const linkById = new Map(all.map((m) => [m.id, { id: m.id, parentMissionId: m.parentMissionId, level: m.level }]));
+        const prepared = [];
+        for (const child of input.children) {
+            if (childLevel === 'project' && !child.projectId) {
+                throw new Error('A project-level child OKR requires projectId');
+            }
+            const mission = createMission({
+                objective: child.objective,
+                ownerTeamId: parent.ownerTeamId,
+                successCriteria: child.successCriteria,
+                currentStrategy: child.currentStrategy,
+                parentMissionId: parentId,
+                level: childLevel,
+                projectId: child.projectId,
+                approval: {
+                    state: PROPOSED_STATE,
+                    proposedBy,
+                    proposedAt: now,
+                },
+            });
+            const reason = validateCascadeLink(mission.id, childLevel, parentId, linkById);
+            if (reason) {
+                throw new Error(`Invalid cascade link for child OKR "${child.objective}": ${reason}`);
+            }
+            // Register the just-validated child so subsequent siblings see it.
+            linkById.set(mission.id, {
+                id: mission.id,
+                parentMissionId: mission.parentMissionId,
+                level: mission.level,
+            });
+            prepared.push({ mission, child });
+        }
+        // ----- Write pass (only reached when ALL children validated) -----------
+        const childMissionIds = [];
+        const krService = KRTrackingService.getInstance();
+        for (const { mission, child } of prepared) {
+            await this.persistMission(mission);
+            // KRs created via KRTrackingService — single source of KR persistence.
+            for (const kr of child.keyResults) {
+                await krService.create({ ...kr, missionId: mission.id });
+            }
+            childMissionIds.push(mission.id);
+        }
+        this.logger.info('Proposed OKR decomposition', {
+            parentId,
+            childLevel,
+            childCount: childMissionIds.length,
+            proposedBy,
+        });
+        return { parentId, childLevel, childMissionIds };
+    }
+    /**
+     * Approve a pending decomposition proposal, making the child mission
+     * cascade-active. Guarded by {@link isValidProposalTransition} so only a
+     * `pending_approval` mission may transition to `approved`.
+     *
+     * @param missionId - ID of the proposed (pending_approval) mission
+     * @param decidedBy - Human owner who approved (e.g. "steve")
+     * @returns The updated mission
+     * @throws If the mission is missing, has no approval state, or the
+     *   `pending_approval → approved` transition is illegal
+     */
+    async approveDecomposition(missionId, decidedBy) {
+        const mission = await this.loadMission(missionId);
+        if (!mission) {
+            throw new Error(`Mission ${missionId} does not exist`);
+        }
+        const current = mission.approval?.state;
+        if (!current) {
+            throw new Error(`Mission ${missionId} has no proposal to approve`);
+        }
+        if (!isValidProposalTransition(current, APPROVED_STATE)) {
+            throw new Error(`Cannot approve a mission in state "${current}"`);
+        }
+        const decided = {
+            ...mission,
+            approval: {
+                ...mission.approval,
+                state: APPROVED_STATE,
+                decidedBy,
+                decidedAt: new Date().toISOString(),
+            },
+            updatedAt: new Date().toISOString(),
+        };
+        await this.persistMission(decided);
+        this.logger.info('Approved OKR decomposition', { missionId, decidedBy });
+        return decided;
+    }
+    /**
+     * Reject a pending decomposition proposal with a required reason. The
+     * rejected mission is excluded from roll-up and autonomous execution.
+     *
+     * @param missionId - ID of the proposed (pending_approval) mission
+     * @param decidedBy - Human owner who rejected (e.g. "steve")
+     * @param reason - Non-empty explanation surfaced back to the proposing agent
+     * @returns The updated mission
+     * @throws If the reason is empty, the mission is missing, has no approval
+     *   state, or the `pending_approval → rejected` transition is illegal
+     */
+    async rejectDecomposition(missionId, decidedBy, reason) {
+        if (!reason || reason.trim().length === 0) {
+            throw new Error('Rejection requires a non-empty reason');
+        }
+        const mission = await this.loadMission(missionId);
+        if (!mission) {
+            throw new Error(`Mission ${missionId} does not exist`);
+        }
+        const current = mission.approval?.state;
+        if (!current) {
+            throw new Error(`Mission ${missionId} has no proposal to reject`);
+        }
+        if (!isValidProposalTransition(current, REJECTED_STATE)) {
+            throw new Error(`Cannot reject a mission in state "${current}"`);
+        }
+        const decided = {
+            ...mission,
+            approval: {
+                ...mission.approval,
+                state: REJECTED_STATE,
+                decidedBy,
+                decidedAt: new Date().toISOString(),
+                rejectionReason: reason.trim(),
+            },
+            updatedAt: new Date().toISOString(),
+        };
+        await this.persistMission(decided);
+        this.logger.info('Rejected OKR decomposition', { missionId, decidedBy, reason: reason.trim() });
+        return decided;
+    }
+    /**
+     * List missions awaiting an owner decision (`approval.state ===
+     * 'pending_approval'`). Optionally scope to the direct children of one parent.
+     *
+     * @param parentId - When provided, only pending children of this parent
+     * @returns Pending-approval missions
+     */
+    async listPendingApprovals(parentId) {
+        const all = await this.loadAllMissions();
+        return all.filter((m) => {
+            if (m.approval?.state !== PROPOSED_STATE)
+                return false;
+            if (parentId !== undefined && m.parentMissionId !== parentId)
+                return false;
+            return true;
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Whether a mission counts as cascade-active: approval absent (legacy) or
+     * explicitly approved.
+     *
+     * @param mission - Mission to test
+     * @returns `true` if the mission participates in the cascade
+     */
+    isCascadeActive(mission) {
+        return mission.approval === undefined || mission.approval.state === APPROVED_STATE;
+    }
+    /**
+     * Resolve a mission's effective level through the SINGLE canonical resolver
+     * shared with the routes' read-migration ({@link resolveMissionLevel}), which
+     * prefers an explicit `level` and otherwise falls back to `deriveLevel` over
+     * the parent chain. A parentless legacy mission therefore resolves to
+     * `company` consistently across every read path.
+     *
+     * @param mission - Mission whose level to resolve
+     * @param byId - All missions indexed by ID for the parent-chain walk
+     * @returns The mission's resolved level
+     */
+    resolveLevel(mission, byId) {
+        return resolveMissionLevel(mission, byId);
+    }
+    /**
+     * Compute the cascade level exactly one tier below the given level.
+     *
+     * @param level - Parent level
+     * @returns The child level, or `null` if `level` is already the bottom tier
+     */
+    nextLevel(level) {
+        const childDepth = MISSION_LEVEL_DEPTH[level] + 1;
+        return MISSION_LEVELS[childDepth] ?? null;
+    }
+    /** Absolute path to the missions directory under the current cwd. */
+    getMissionsDir() {
+        return path.join(process.cwd(), CREWLY_HOME, MISSIONS_DIR);
+    }
+    /** Absolute path to a single mission's JSON file. */
+    getMissionPath(missionId) {
+        return path.join(this.getMissionsDir(), `${missionId}.json`);
+    }
+    /**
+     * Validate + normalize a parsed mission document read from disk.
+     *
+     * - Returns `null` for anything that is not structurally a {@link Mission}
+     *   (corrupt / hand-edited / wrong shape), so callers never trust junk.
+     * - When `approval` is present but `approval.state` is NOT a recognized
+     *   {@link isValidProposalState}, the state is normalized to
+     *   {@link CORRUPT_APPROVAL_FALLBACK} (`rejected`). This deliberately treats a
+     *   corrupt governance state as INACTIVE — neither cascade-active nor a
+     *   recognized pending state — rather than silently trusting an unknown
+     *   string (which would otherwise be neither active nor pending and could
+     *   crash transition guards).
+     *
+     * @param value - Raw JSON-parsed value
+     * @returns A validated, normalized Mission, or `null` if not a valid Mission
+     */
+    sanitizeMission(value) {
+        if (!isMission(value))
+            return null;
+        const mission = value;
+        if (mission.approval !== undefined && !isValidProposalState(mission.approval.state)) {
+            this.logger.warn('Normalized corrupt approval.state to inactive', {
+                missionId: mission.id,
+                rawState: mission.approval.state,
+            });
+            return {
+                ...mission,
+                approval: { ...mission.approval, state: CORRUPT_APPROVAL_FALLBACK },
+            };
+        }
+        return mission;
+    }
+    /**
+     * Load a single mission from disk, validated + normalized via
+     * {@link sanitizeMission}.
+     *
+     * @param missionId - Mission ID
+     * @returns The mission, or `null` if missing/unreadable/not a valid Mission
+     */
+    async loadMission(missionId) {
+        try {
+            const raw = await fs.readFile(this.getMissionPath(missionId), 'utf-8');
+            return this.sanitizeMission(JSON.parse(raw));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Load all missions from disk, skipping unreadable AND structurally-invalid
+     * files (each validated + normalized via {@link sanitizeMission}).
+     *
+     * @returns Array of valid missions
+     */
+    async loadAllMissions() {
+        const dir = this.getMissionsDir();
+        let files = [];
+        try {
+            files = (await fs.readdir(dir)).filter((f) => f.endsWith('.json'));
+        }
+        catch {
+            return [];
+        }
+        const missions = await Promise.all(files.map(async (f) => {
+            try {
+                const raw = await fs.readFile(path.join(dir, f), 'utf-8');
+                return this.sanitizeMission(JSON.parse(raw));
+            }
+            catch {
+                return null;
+            }
+        }));
+        return missions.filter((m) => m !== null);
+    }
+    /**
+     * Persist a mission to disk (creating the missions directory if needed).
+     *
+     * @param mission - Mission to write
+     */
+    async persistMission(mission) {
+        const dir = this.getMissionsDir();
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(this.getMissionPath(mission.id), JSON.stringify(mission, null, 2));
+    }
+}
+//# sourceMappingURL=okr-cascade.service.js.map

package/dist/backend/backend/src/services/v3/okr-cascade.service.js.map

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

package/dist/backend/backend/src/services/v3/okr-review.service.d.ts

@@ -50,6 +50,17 @@ export declare class OKRReviewService {
      * Update mission fields on disk (partial merge).
      */
     private updateMissionReview;
+    /**
+     * Refresh a parent mission's `lastReviewSummary` using the cascade roll-up.
+     *
+     * Called on-demand after a child review so the parent reflects its children's
+     * latest progress without a separate scheduled review. No-op when the
+     * reviewed mission has no parent or the parent has vanished. Errors are
+     * swallowed and logged — a roll-up refresh must never fail the child review.
+     *
+     * @param parentMissionId - The reviewed mission's parent (may be undefined)
+     */
+    private refreshParentRollup;
     /**
      * Extract previous overall progress from review summary string.
      */

package/dist/backend/backend/src/services/v3/okr-review.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"okr-review.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/okr-review.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,oCAAoC,CAAC;AAgB5C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAyEhE;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvF;;OAEG;YACW,WAAW;IAUzB;;OAEG;YACW,mBAAmB;IAYjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAKhC"}
+{"version":3,"file":"okr-review.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/okr-review.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGf,MAAM,oCAAoC,CAAC;AA6B5C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;;;;;;;;;;;OAYG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA8EhE;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvF;;OAEG;YACW,WAAW;IAUzB;;OAEG;YACW,mBAAmB;IAYjC;;;;;;;;;OASG;YACW,mBAAmB;IAwBjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAKhC"}

package/dist/backend/backend/src/services/v3/okr-review.service.js

@@ -22,6 +22,16 @@ import { MissionExecutorService } from './mission-executor.service.js';
 function getMissionsDir() {
     return path.join(process.cwd(), '.crewly', 'missions');
 }
+/**
+ * Build the one-line review summary string persisted on a mission. Kept in one
+ * place so the on-demand parent roll-up refresh and the self-review write stay
+ * consistent and machine-parseable (see {@link OKRReviewService}).
+ */
+function formatCascadeSummary(summary) {
+    return (`Roll-up: ${summary.rolledUpProgress}% ` +
+        `(own ${summary.overallProgress}%, ${summary.childMissionCount} child OKR(s)) | ` +
+        `Recommendation: ${summary.recommendation}`);
+}
 // ---------------------------------------------------------------------------
 // Service
 // ---------------------------------------------------------------------------
@@ -109,6 +119,10 @@ export class OKRReviewService {
             staleCycles: newStaleCycles,
             lastReviewAt: result.reviewedAt,
         });
+        // Cross-level roll-up: on-demand at review time, refresh this mission's
+        // parent so the parent's lastReviewSummary reflects the (now-updated) child.
+        // Event-driven refresh on every child measurement is a follow-up (spec §4.3).
+        await this.refreshParentRollup(mission.parentMissionId);
         this.logger.info('OKR review completed', {
             missionId,
             progress: finalSummary.overallProgress,
@@ -208,6 +222,42 @@ export class OKRReviewService {
         const filePath = path.join(getMissionsDir(), `${missionId}.json`);
         await fs.writeFile(filePath, JSON.stringify(merged, null, 2));
     }
+    /**
+     * Refresh a parent mission's `lastReviewSummary` using the cascade roll-up.
+     *
+     * Called on-demand after a child review so the parent reflects its children's
+     * latest progress without a separate scheduled review. No-op when the
+     * reviewed mission has no parent or the parent has vanished. Errors are
+     * swallowed and logged — a roll-up refresh must never fail the child review.
+     *
+     * @param parentMissionId - The reviewed mission's parent (may be undefined)
+     */
+    async refreshParentRollup(parentMissionId) {
+        if (!parentMissionId)
+            return;
+        const parent = await this.loadMission(parentMissionId);
+        if (!parent)
+            return;
+        try {
+            const krService = KRTrackingService.getInstance();
+            const rollup = await krService.computeCascadeOKRProgress(parentMissionId);
+            await this.updateMissionReview(parentMissionId, {
+                lastReviewSummary: formatCascadeSummary(rollup),
+                lastReviewAt: new Date().toISOString(),
+            });
+            this.logger.info('Refreshed parent roll-up summary', {
+                parentMissionId,
+                rolledUpProgress: rollup.rolledUpProgress,
+                childMissionCount: rollup.childMissionCount,
+            });
+        }
+        catch (err) {
+            this.logger.warn('Parent roll-up refresh failed', {
+                parentMissionId,
+                error: err.message,
+            });
+        }
+    }
     /**
      * Extract previous overall progress from review summary string.
      */

package/dist/backend/backend/src/services/v3/okr-review.service.js.map

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

package/dist/backend/backend/src/services/wiki/sop-catalog.service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * SOP catalog service.
+ *
+ * `config/sops/` is a *catalog* of reusable SOPs (a marketplace), NOT content a
+ * team owns automatically. A team owns a SOP only once it is INSTALLED — copied
+ * into the team's own `~/.crewly/teams/<id>/sops/` store, which the wiki then
+ * surfaces (via the overlay resolver) under the team's `sop/` folder.
+ *
+ * This service lists the catalog, reports which entries a given team has
+ * installed, and performs install / uninstall (copy / remove of the per-team
+ * copy — the catalog original is never touched).
+ *
+ * @module services/wiki/sop-catalog.service
+ */
+/** A single SOP available in the catalog. */
+export interface SopCatalogEntry {
+    /** Catalog-relative path, e.g. `pm/progress-tracking.md`. Stable id. */
+    path: string;
+    /** Display title (from frontmatter `title:` or the filename). */
+    title: string;
+    /** Top-level category folder (`common`, `developer`, …) or `general`. */
+    category: string;
+    /** File size in bytes. */
+    bytes: number;
+    /** Whether the queried team has this SOP installed. */
+    installed: boolean;
+}
+/**
+ * Resolve the catalog directory (`<configDir>/sops`). `<configDir>` mirrors the
+ * convention used by other services (`<cwd>/config`), overridable via
+ * `CREWLY_CONFIG_DIR`.
+ *
+ * @returns Absolute path to the SOP catalog directory.
+ */
+export declare function sopCatalogDir(): string;
+/**
+ * Resolve a team's installed-SOP store from its vault path. The store is a
+ * sibling of the vault (`<vault>/../sops`), matching the overlay resolver.
+ *
+ * @param vaultPath - Absolute path to the team vault (`.../teams/<id>/wiki`).
+ * @returns Absolute path to the team's installed-SOP directory.
+ */
+export declare function teamSopsDir(vaultPath: string): string;
+/**
+ * The SOP catalog service. Stateless; methods take the team vault path so the
+ * same instance serves any team.
+ */
+export declare class SopCatalogService {
+    /**
+     * List the catalog, annotated with whether the given team has each installed.
+     *
+     * @param vaultPath - The team vault path (to resolve its installed store).
+     * @returns Catalog entries sorted by category then path.
+     */
+    list(vaultPath: string): Promise<SopCatalogEntry[]>;
+    /**
+     * Install a catalog SOP into the team's store (copy, preserving the relative
+     * path). Idempotent — re-installing refreshes the copy to the catalog version.
+     *
+     * @param vaultPath - The team vault path.
+     * @param sopPath - Catalog-relative SOP path (e.g. `pm/progress-tracking.md`).
+     * @returns `{ installed: true, path }`.
+     * @throws Error when the path is unsafe or the catalog file is missing.
+     */
+    install(vaultPath: string, sopPath: string): Promise<{
+        installed: true;
+        path: string;
+    }>;
+    /**
+     * Remove a SOP from the team's store. The catalog original is untouched.
+     * Idempotent — removing a not-installed SOP is a no-op.
+     *
+     * @param vaultPath - The team vault path.
+     * @param sopPath - Catalog-relative SOP path.
+     * @returns `{ installed: false, path }`.
+     * @throws Error when the path is unsafe.
+     */
+    uninstall(vaultPath: string, sopPath: string): Promise<{
+        installed: false;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=sop-catalog.service.d.ts.map

package/dist/backend/backend/src/services/wiki/sop-catalog.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sop-catalog.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/sop-catalog.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD;AA0DD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;;;OAKG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA4BzD;;;;;;;;OAQG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAU7F;;;;;;;;OAQG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAsBjG"}