skill-flow 1.0.0

package/dist/services/inventory-service.js

@@ -0,0 +1,186 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { hashDirectory, slugify } from "../utils/fs.js";
+export class InventoryService {
+    static IGNORED_DIRECTORIES = new Set([
+        ".git",
+        "node_modules",
+    ]);
+    async scanSource(sourceId, checkoutPath) {
+        const skillFiles = await this.findSkillFiles(checkoutPath);
+        const candidates = [];
+        const invalidLeafs = [];
+        for (const skillFilePath of skillFiles) {
+            const leafRoot = path.dirname(skillFilePath);
+            const relativePath = path.relative(checkoutPath, leafRoot) || ".";
+            const raw = await fs.readFile(skillFilePath, "utf8");
+            const linkName = path.basename(leafRoot) || sourceId;
+            const parsed = this.parseSkillFile(raw, linkName);
+            if (!parsed.valid) {
+                invalidLeafs.push({
+                    path: relativePath,
+                    reason: parsed.reason,
+                });
+                continue;
+            }
+            const safeName = slugify(parsed.name) || linkName || sourceId;
+            candidates.push({
+                id: `${sourceId}:${relativePath}`,
+                sourceId,
+                name: safeName,
+                linkName,
+                title: parsed.title,
+                description: parsed.description,
+                relativePath,
+                absolutePath: leafRoot,
+                skillFilePath,
+                contentHash: await hashDirectory(leafRoot),
+                metadataWarnings: parsed.metadataWarnings,
+                valid: true,
+                dedupeKey: `${parsed.name}\n${parsed.description}`,
+            });
+        }
+        const leafs = this.dedupeCandidates(candidates, invalidLeafs);
+        leafs.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
+        invalidLeafs.sort((left, right) => left.path.localeCompare(right.path));
+        return { leafs, invalidLeafs };
+    }
+    async findSkillFiles(rootPath) {
+        const discovered = [];
+        async function walk(currentPath) {
+            const entries = await fs.readdir(currentPath, { withFileTypes: true });
+            const files = entries
+                .filter((entry) => entry.isFile())
+                .sort((left, right) => left.name.localeCompare(right.name));
+            const visibleDirectories = entries
+                .filter((entry) => entry.isDirectory() &&
+                !InventoryService.IGNORED_DIRECTORIES.has(entry.name) &&
+                !entry.name.startsWith("."))
+                .sort((left, right) => left.name.localeCompare(right.name));
+            const hiddenDirectories = entries
+                .filter((entry) => entry.isDirectory() &&
+                !InventoryService.IGNORED_DIRECTORIES.has(entry.name) &&
+                entry.name.startsWith("."))
+                .sort((left, right) => left.name.localeCompare(right.name));
+            for (const entry of files) {
+                if (entry.name === "SKILL.md") {
+                    discovered.push(path.join(currentPath, entry.name));
+                }
+            }
+            for (const entry of [...visibleDirectories, ...hiddenDirectories]) {
+                await walk(path.join(currentPath, entry.name));
+            }
+        }
+        await walk(rootPath);
+        return discovered;
+    }
+    parseSkillFile(raw, parentDirName) {
+        const lines = raw.split(/\r?\n/);
+        const frontmatter = this.parseFrontmatter(lines);
+        if (!frontmatter) {
+            return { valid: false, reason: "SKILL.md must start with YAML frontmatter" };
+        }
+        if (!Object.hasOwn(frontmatter.data, "name")) {
+            return {
+                valid: false,
+                reason: "SKILL.md frontmatter must include required field 'name'",
+            };
+        }
+        if (!Object.hasOwn(frontmatter.data, "description")) {
+            return {
+                valid: false,
+                reason: "SKILL.md frontmatter must include required field 'description'",
+            };
+        }
+        const bodyLines = lines.slice(frontmatter.bodyStartLine);
+        const firstHeading = bodyLines.find((line) => line.trim().startsWith("# "));
+        const rawName = (frontmatter.data.name ?? "").trim();
+        const rawDescription = frontmatter.data.description ?? "";
+        const metadataWarnings = [];
+        if (rawName.length < 1 ||
+            rawName.length > 64 ||
+            !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(rawName)) {
+            metadataWarnings.push("name should be 1-64 chars, lowercase letters/numbers/hyphens only, with no leading/trailing hyphen or consecutive '--'");
+        }
+        if (rawName !== parentDirName) {
+            metadataWarnings.push(`name should match parent directory name '${parentDirName}'`);
+        }
+        if (rawDescription.trim().length === 0) {
+            metadataWarnings.push("description should be non-empty");
+        }
+        if (rawDescription.length > 1024) {
+            metadataWarnings.push("description should be at most 1024 characters");
+        }
+        const title = firstHeading?.trim().slice(2).trim() || rawName || "Untitled skill";
+        return {
+            valid: true,
+            name: rawName,
+            title,
+            description: rawDescription.trim(),
+            metadataWarnings,
+        };
+    }
+    dedupeCandidates(candidates, invalidLeafs) {
+        const keptByKey = new Map();
+        for (const candidate of candidates) {
+            if (keptByKey.has(candidate.dedupeKey)) {
+                const kept = keptByKey.get(candidate.dedupeKey);
+                invalidLeafs.push({
+                    path: candidate.relativePath,
+                    reason: `Duplicate skill content skipped because ${kept.relativePath} was discovered first`,
+                });
+                continue;
+            }
+            const { dedupeKey: _dedupeKey, ...leaf } = candidate;
+            keptByKey.set(candidate.dedupeKey, leaf);
+        }
+        return [...keptByKey.values()];
+    }
+    parseFrontmatter(lines) {
+        if (lines[0]?.trim() !== "---") {
+            return undefined;
+        }
+        const data = {};
+        let index = 1;
+        while (index < lines.length) {
+            const line = lines[index] ?? "";
+            if (line.trim() === "---") {
+                return { data, bodyStartLine: index + 1 };
+            }
+            const pair = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+            if (!pair) {
+                index += 1;
+                continue;
+            }
+            const key = pair[1];
+            const rest = pair[2];
+            if (!key || rest === undefined) {
+                index += 1;
+                continue;
+            }
+            if (rest === "|" || rest === ">") {
+                const blockLines = [];
+                index += 1;
+                while (index < lines.length) {
+                    const blockLine = lines[index] ?? "";
+                    if (blockLine.length === 0) {
+                        blockLines.push("");
+                        index += 1;
+                        continue;
+                    }
+                    if (!blockLine.startsWith("  ")) {
+                        break;
+                    }
+                    blockLines.push(blockLine.slice(2));
+                    index += 1;
+                }
+                data[key] = blockLines.join("\n").trim();
+                continue;
+            }
+            data[key] = rest.trim();
+            index += 1;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=inventory-service.js.map

package/dist/services/inventory-service.js.map

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

package/dist/services/skill-flow.d.ts

@@ -0,0 +1,60 @@
+import type { DeploymentAction, DeploymentPlan, DeploymentTargetName, DoctorReport, LockFile, Manifest, Result, SourceBinding, WorkflowSummary } from "../domain/types.js";
+import { StateStore } from "../state/store.js";
+import { DeploymentApplier } from "./deployment-applier.js";
+import { DeploymentPlanner } from "./deployment-planner.js";
+import { DoctorService } from "./doctor-service.js";
+import { InventoryService } from "./inventory-service.js";
+import { SourceService } from "./source-service.js";
+import { WorkflowService } from "./workflow-service.js";
+export type DraftBinding = {
+    enabledTargets: DeploymentTargetName[];
+    selectedLeafIds: string[];
+};
+export declare class SkillFlowApp {
+    readonly store: StateStore;
+    readonly inventoryService: InventoryService;
+    readonly sourceService: SourceService;
+    readonly planner: DeploymentPlanner;
+    readonly applier: DeploymentApplier;
+    readonly doctorService: DoctorService;
+    readonly workflowService: WorkflowService;
+    addSource(locator: string): Promise<Result<import("./source-service.js").SourceSnapshot>>;
+    listWorkflows(): Promise<Result<{
+        summaries: WorkflowSummary[];
+    }>>;
+    getConfigData(): Promise<Result<{
+        manifest: Manifest;
+        lockFile: LockFile;
+        summaries: WorkflowSummary[];
+    }>>;
+    getAvailableTargets(): Promise<DeploymentTargetName[]>;
+    previewDraft(sourceId: string, draft: DraftBinding): Promise<Result<{
+        plan: DeploymentPlan;
+        manifest: Manifest;
+        lockFile: LockFile;
+    }>>;
+    applyDraft(sourceId: string, draft: DraftBinding): Promise<Result<{
+        actions: DeploymentAction[];
+        draft: DraftBinding;
+    }>>;
+    updateSources(sourceIds?: string[]): Promise<Result<{
+        updated: Array<{
+            sourceId: string;
+            changed: boolean;
+            addedLeafIds: string[];
+            removedLeafIds: string[];
+            invalidatedLeafIds: string[];
+        }>;
+    }>>;
+    doctor(): Promise<Result<DoctorReport>>;
+    uninstall(sourceIds: string[]): Promise<Result<{
+        removed: string[];
+        warnings: string[];
+    }>>;
+    bindingFromDraft(draft: DraftBinding): SourceBinding;
+    private prepareManifestForDraft;
+    private findExactDuplicateLeafSelections;
+    private getExactDuplicateKey;
+    private planForAffectedSources;
+    private hasActiveTargets;
+}

package/dist/services/skill-flow.js

@@ -0,0 +1,260 @@
+import fs from "node:fs/promises";
+import { createChannelAdapters } from "../adapters/channel-adapters.js";
+import { StateStore } from "../state/store.js";
+import { hashDirectory, pathExists, removePath } from "../utils/fs.js";
+import { fail, ok } from "../utils/result.js";
+import { DeploymentApplier } from "./deployment-applier.js";
+import { DeploymentPlanner } from "./deployment-planner.js";
+import { DoctorService } from "./doctor-service.js";
+import { InventoryService } from "./inventory-service.js";
+import { SourceService } from "./source-service.js";
+import { WorkflowService } from "./workflow-service.js";
+export class SkillFlowApp {
+    store = new StateStore();
+    inventoryService = new InventoryService();
+    sourceService = new SourceService(this.store, this.inventoryService);
+    planner = new DeploymentPlanner(createChannelAdapters());
+    applier = new DeploymentApplier();
+    doctorService = new DoctorService();
+    workflowService = new WorkflowService();
+    async addSource(locator) {
+        return this.sourceService.addSource(locator);
+    }
+    async listWorkflows() {
+        const reconciled = await this.sourceService.reconcileInventory(undefined, {
+            force: true,
+        });
+        if (!reconciled.ok) {
+            return fail(reconciled.errors, reconciled.warnings);
+        }
+        await this.store.init();
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        return ok({
+            summaries: this.workflowService.getSummaries(manifest, lockFile),
+        });
+    }
+    async getConfigData() {
+        const reconciled = await this.sourceService.reconcileInventory(undefined, {
+            force: true,
+        });
+        if (!reconciled.ok) {
+            return fail(reconciled.errors, reconciled.warnings);
+        }
+        await this.store.init();
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        return ok({
+            manifest,
+            lockFile,
+            summaries: this.workflowService.getSummaries(manifest, lockFile),
+        });
+    }
+    async getAvailableTargets() {
+        const adapters = createChannelAdapters();
+        const availableTargets = [];
+        for (const adapter of adapters) {
+            const detection = await adapter.detect();
+            if (detection.available) {
+                availableTargets.push(adapter.target);
+            }
+        }
+        return availableTargets;
+    }
+    async previewDraft(sourceId, draft) {
+        // config TUI state flow:
+        //   draft -> previewDraft() -> plan only
+        //   draft -> applyDraft()   -> plan + filesystem + manifest/lock writes
+        await this.store.init();
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        const prepared = this.prepareManifestForDraft(manifest, lockFile, sourceId, draft);
+        const plan = await this.planForAffectedSources(prepared.manifest, lockFile, sourceId);
+        if (!plan.ok) {
+            return fail(plan.errors, [...prepared.warnings, ...plan.warnings]);
+        }
+        return ok({ plan: plan.data, manifest: prepared.manifest, lockFile }, [...prepared.warnings, ...plan.warnings]);
+    }
+    async applyDraft(sourceId, draft) {
+        const reconciled = await this.sourceService.reconcileInventory([sourceId], {
+            force: true,
+        });
+        if (!reconciled.ok) {
+            return fail(reconciled.errors, reconciled.warnings);
+        }
+        await this.store.init();
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        const prepared = this.prepareManifestForDraft(manifest, lockFile, sourceId, draft);
+        const plan = await this.planForAffectedSources(prepared.manifest, lockFile, sourceId);
+        if (!plan.ok) {
+            return fail(plan.errors, [...prepared.warnings, ...plan.warnings]);
+        }
+        const applyResult = await this.applier.applyPlan(lockFile, plan.data.actions);
+        await this.store.writeManifest(prepared.manifest);
+        await this.store.writeLock(lockFile);
+        if (!applyResult.ok) {
+            return fail(applyResult.errors, [...prepared.warnings, ...plan.warnings, ...applyResult.warnings]);
+        }
+        return ok({ actions: plan.data.actions, draft: prepared.draft }, [...prepared.warnings, ...plan.warnings, ...applyResult.warnings]);
+    }
+    async updateSources(sourceIds) {
+        const reconciled = await this.sourceService.reconcileInventory(sourceIds, {
+            force: true,
+        });
+        if (!reconciled.ok) {
+            return fail(reconciled.errors, reconciled.warnings);
+        }
+        const updated = await this.sourceService.updateSources(sourceIds);
+        if (!updated.ok) {
+            return updated;
+        }
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        const activeSourceIds = manifest.sources
+            .map((source) => source.id)
+            .filter((id) => this.hasActiveTargets(manifest, id));
+        for (const sourceId of activeSourceIds) {
+            const plan = await this.planner.planForSource(sourceId, manifest, lockFile);
+            if (!plan.ok) {
+                return fail(plan.errors, plan.warnings);
+            }
+            await this.applier.applyPlan(lockFile, plan.data.actions);
+        }
+        await this.store.writeLock(lockFile);
+        return updated;
+    }
+    async doctor() {
+        const reconciled = await this.sourceService.reconcileInventory();
+        if (!reconciled.ok) {
+            return fail(reconciled.errors, reconciled.warnings);
+        }
+        await this.store.init();
+        const manifest = await this.store.readManifest();
+        const lockFile = await this.store.readLock();
+        return this.doctorService.run(manifest, lockFile);
+    }
+    async uninstall(sourceIds) {
+        await this.store.init();
+        const lockFile = await this.store.readLock();
+        const warnings = [];
+        for (const sourceId of sourceIds) {
+            const deployments = lockFile.deployments.filter((deployment) => deployment.sourceId === sourceId);
+            for (const deployment of deployments) {
+                if (!(await pathExists(deployment.targetPath))) {
+                    continue;
+                }
+                if (deployment.strategy === "symlink") {
+                    const stats = await fs.lstat(deployment.targetPath);
+                    if (stats.isSymbolicLink()) {
+                        await removePath(deployment.targetPath);
+                    }
+                    else {
+                        warnings.push(`Skipped ${deployment.targetPath} because it no longer looks like a managed symlink.`);
+                    }
+                    continue;
+                }
+                const currentHash = await hashDirectory(deployment.targetPath);
+                if (currentHash === deployment.contentHash) {
+                    await removePath(deployment.targetPath);
+                }
+                else {
+                    warnings.push(`Skipped ${deployment.targetPath} because the copied skill has drifted from saved state.`);
+                }
+            }
+        }
+        const removed = await this.sourceService.removeSource(sourceIds);
+        if (!removed.ok) {
+            return fail(removed.errors, removed.warnings);
+        }
+        return ok({ removed: removed.data.removed, warnings });
+    }
+    bindingFromDraft(draft) {
+        const targets = {};
+        for (const target of draft.enabledTargets) {
+            targets[target] = {
+                enabled: true,
+                leafIds: [...draft.selectedLeafIds],
+            };
+        }
+        return { targets };
+    }
+    prepareManifestForDraft(manifest, lockFile, sourceId, draft) {
+        manifest.bindings[sourceId] = this.bindingFromDraft(draft);
+        const conflictingLeafIds = this.findExactDuplicateLeafSelections(manifest, lockFile, sourceId, draft.enabledTargets);
+        const normalizedDraft = {
+            enabledTargets: [...draft.enabledTargets],
+            selectedLeafIds: draft.selectedLeafIds.filter((leafId) => !conflictingLeafIds.has(leafId)),
+        };
+        manifest.bindings[sourceId] = this.bindingFromDraft(normalizedDraft);
+        const warnings = [...conflictingLeafIds].map((leafId) => ({
+            code: "DUPLICATE_LEAF_SELECTION_SKIPPED",
+            message: `${leafId} skipped because an identical skill is already selected in another workflow group.`,
+        }));
+        return {
+            manifest,
+            draft: normalizedDraft,
+            warnings,
+        };
+    }
+    findExactDuplicateLeafSelections(manifest, lockFile, currentSourceId, enabledTargets) {
+        const conflictingKeys = new Set();
+        for (const source of manifest.sources) {
+            if (source.id === currentSourceId) {
+                continue;
+            }
+            const binding = manifest.bindings[source.id];
+            if (!binding) {
+                continue;
+            }
+            for (const target of enabledTargets) {
+                const targetBinding = binding.targets[target];
+                if (!targetBinding?.enabled) {
+                    continue;
+                }
+                for (const leafId of targetBinding.leafIds) {
+                    const leaf = lockFile.leafInventory.find((item) => item.id === leafId);
+                    if (!leaf) {
+                        continue;
+                    }
+                    conflictingKeys.add(this.getExactDuplicateKey(leaf));
+                }
+            }
+        }
+        const currentLeafs = lockFile.leafInventory.filter((leaf) => leaf.sourceId === currentSourceId);
+        return new Set(currentLeafs
+            .filter((leaf) => conflictingKeys.has(this.getExactDuplicateKey(leaf)))
+            .map((leaf) => leaf.id));
+    }
+    getExactDuplicateKey(leaf) {
+        return `${leaf.linkName}\n${leaf.name}\n${leaf.description}`;
+    }
+    async planForAffectedSources(manifest, lockFile, primarySourceId) {
+        const sourceIds = manifest.sources
+            .map((source) => source.id)
+            .filter((sourceId) => sourceId === primarySourceId || this.hasActiveTargets(manifest, sourceId));
+        const actions = [];
+        const warnings = [];
+        for (const sourceId of sourceIds) {
+            const plan = await this.planner.planForSource(sourceId, manifest, lockFile);
+            if (!plan.ok) {
+                return fail(plan.errors, [...warnings, ...plan.warnings]);
+            }
+            actions.push(...plan.data.actions);
+            warnings.push(...plan.warnings);
+        }
+        return ok({
+            actions,
+            warnings,
+            blocked: actions.filter((action) => action.kind === "blocked"),
+        }, warnings);
+    }
+    hasActiveTargets(manifest, sourceId) {
+        const binding = manifest.bindings[sourceId];
+        if (!binding) {
+            return false;
+        }
+        return Object.values(binding.targets).some((target) => target?.enabled);
+    }
+}
+//# sourceMappingURL=skill-flow.js.map

package/dist/services/skill-flow.js.map

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

package/dist/services/source-service.d.ts

@@ -0,0 +1,35 @@
+import type { Result, SourceLockRecord, SourceManifestRecord } from "../domain/types.js";
+import { StateStore } from "../state/store.js";
+import { InventoryService } from "./inventory-service.js";
+export type SourceSnapshot = {
+    manifest: SourceManifestRecord;
+    lock: SourceLockRecord;
+    leafCount: number;
+    invalidLeafCount: number;
+};
+export declare class SourceService {
+    private readonly store;
+    private readonly inventoryService;
+    constructor(store: StateStore, inventoryService: InventoryService);
+    addSource(locator: string): Promise<Result<SourceSnapshot>>;
+    updateSources(sourceIds?: string[]): Promise<Result<{
+        updated: Array<{
+            sourceId: string;
+            changed: boolean;
+            addedLeafIds: string[];
+            removedLeafIds: string[];
+            invalidatedLeafIds: string[];
+        }>;
+    }>>;
+    removeSource(sourceIds: string[]): Promise<Result<{
+        removed: string[];
+    }>>;
+    reconcileInventory(sourceIds?: string[], options?: {
+        force?: boolean;
+    }): Promise<Result<{
+        updatedSourceIds: string[];
+    }>>;
+    private needsInventoryReconcile;
+    private buildSnapshot;
+    private normalizeLocator;
+}