skill-flow 1.0.3 → 1.0.4

package/dist/services/workspace-bootstrap-service.js

@@ -0,0 +1,148 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { TARGET_DEFINITIONS, TARGET_ORDER } from "../utils/constants.js";
+import { hashDirectory, pathExists, readJsonFile } from "../utils/fs.js";
+import { deriveSourceId } from "../utils/source-id.js";
+export class WorkspaceBootstrapService {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async detectUnmanagedExternalSkills(manifest, lockFile, onEvent) {
+        const managedLocators = new Set(manifest.sources
+            .filter((source) => source.kind === "local")
+            .map((source) => path.resolve(source.locator)));
+        const managedCheckouts = new Set(lockFile.sources.map((source) => path.resolve(source.checkoutPath)));
+        const managedTargetPaths = new Set(lockFile.deployments.map((deployment) => path.resolve(deployment.targetPath)));
+        const agentsOrigins = await this.readAgentsOrigins();
+        const grouped = new Map();
+        onEvent?.({
+            phase: "scan-external-roots",
+            level: "info",
+            message: "Scanning detected agent roots for unmanaged skills...",
+        });
+        for (const target of TARGET_ORDER) {
+            const definition = TARGET_DEFINITIONS[target];
+            const overrideRoot = process.env[definition.envVar]?.trim();
+            const roots = [
+                ...new Set([
+                    ...(overrideRoot ? [path.resolve(overrideRoot)] : []),
+                    ...definition.writeRootCandidates,
+                    ...definition.compatReadRootCandidates,
+                ]),
+            ];
+            for (const root of roots) {
+                if (!(await pathExists(root))) {
+                    continue;
+                }
+                const entries = await fs.readdir(root, { withFileTypes: true });
+                for (const entry of entries) {
+                    const skillDir = path.join(root, entry.name);
+                    const isDirectoryLike = entry.isDirectory() ||
+                        (entry.isSymbolicLink() &&
+                            (await fs.stat(skillDir).then((stats) => stats.isDirectory()).catch(() => false)));
+                    if (!isDirectoryLike) {
+                        continue;
+                    }
+                    if (!(await pathExists(path.join(skillDir, "SKILL.md")))) {
+                        continue;
+                    }
+                    const resolvedPath = await fs.realpath(skillDir).catch(() => path.resolve(skillDir));
+                    if (this.isUnderSkillFlowStore(resolvedPath)) {
+                        continue;
+                    }
+                    if (managedLocators.has(resolvedPath) ||
+                        managedCheckouts.has(resolvedPath) ||
+                        managedTargetPaths.has(resolvedPath)) {
+                        continue;
+                    }
+                    const contentHash = await hashDirectory(resolvedPath);
+                    const groupKey = `${entry.name}\n${contentHash}`;
+                    const current = grouped.get(groupKey);
+                    if (current) {
+                        current.targets.add(target);
+                        continue;
+                    }
+                    grouped.set(groupKey, {
+                        path: resolvedPath,
+                        displayName: entry.name,
+                        hash: contentHash,
+                        targets: new Set([target]),
+                        origin: agentsOrigins.get(entry.name),
+                    });
+                }
+            }
+        }
+        const takenSourceIds = new Set(manifest.sources.map((source) => source.id));
+        const results = [];
+        for (const item of grouped.values()) {
+            const baseId = deriveSourceId(item.path);
+            const sourceId = this.allocateSourceId(baseId, item.targets, takenSourceIds);
+            takenSourceIds.add(sourceId);
+            results.push({
+                path: item.path,
+                displayName: item.displayName,
+                sourceId,
+                importedFromTargets: TARGET_ORDER.filter((target) => item.targets.has(target)),
+                ...(item.origin?.originLocator ? { originLocator: item.origin.originLocator } : {}),
+                ...(item.origin?.originRequestedPath
+                    ? { originRequestedPath: item.origin.originRequestedPath }
+                    : {}),
+                ...(item.origin?.originBranch ? { originBranch: item.origin.originBranch } : {}),
+            });
+        }
+        return results.sort((left, right) => left.displayName.localeCompare(right.displayName));
+    }
+    isUnderSkillFlowStore(candidatePath) {
+        const relative = path.relative(this.store.rootPath, candidatePath);
+        return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
+    }
+    allocateSourceId(baseId, targets, takenSourceIds) {
+        if (!takenSourceIds.has(baseId)) {
+            return baseId;
+        }
+        for (const target of TARGET_ORDER) {
+            if (!targets.has(target)) {
+                continue;
+            }
+            const suffixed = `${baseId}-${TARGET_DEFINITIONS[target].writerKey}`;
+            if (!takenSourceIds.has(suffixed)) {
+                return suffixed;
+            }
+        }
+        let index = 2;
+        while (takenSourceIds.has(`${baseId}-${index}`)) {
+            index += 1;
+        }
+        return `${baseId}-${index}`;
+    }
+    async readAgentsOrigins() {
+        const lockPath = path.join(os.homedir(), ".agents", ".skill-lock.json");
+        const lockFile = await readJsonFile(lockPath, {});
+        const results = new Map();
+        for (const [name, record] of Object.entries(lockFile.skills ?? {})) {
+            if (!record || record.sourceType !== "github") {
+                continue;
+            }
+            results.set(name, {
+                originLocator: record.source ? `https://github.com/${record.source}.git` : undefined,
+                originRequestedPath: record.skillPath,
+                originBranch: record.branch ?? record.sourceBranch ?? this.parseBranchFromSourceUrl(record.sourceUrl),
+            });
+        }
+        return results;
+    }
+    parseBranchFromSourceUrl(sourceUrl) {
+        if (!sourceUrl) {
+            return undefined;
+        }
+        const treeIndex = sourceUrl.indexOf("/tree/");
+        if (treeIndex === -1) {
+            return undefined;
+        }
+        const tail = sourceUrl.slice(treeIndex + "/tree/".length);
+        return tail.split("/")[0] || undefined;
+    }
+}
+//# sourceMappingURL=workspace-bootstrap-service.js.map

package/dist/services/workspace-bootstrap-service.js.map

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

package/dist/state/store.js

@@ -34,6 +34,7 @@ export class StateStore {
         return path.join(this.stateRoot, "lock.json");
     }
     async init() {
+        await ensureDir(this.getSourceRoot("local"));
         await ensureDir(this.getSourceRoot("git"));
         await ensureDir(this.getSourceRoot("clawhub"));
         await ensureDir(this.catalogRoot);

package/dist/state/store.js.map

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

package/dist/tests/skill-flow.test.js

@@ -342,7 +342,7 @@ describe.sequential("skill-flow", () => {
             id: "garrytan-gstack",
             locator: "git@github.com:garrytan/gstack.git",
             displayName: "gstack",
-        })).toBe("gstack(@garrytan)");
+        })).toBe("gstack@garrytan");
     });
     test("prefers groupName-skillName for projected collisions", () => {
         const projected = resolveProjectedSkillNames([
@@ -482,7 +482,7 @@ description: |
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -509,7 +509,7 @@ description: |
             "browse/SKILL.md": skillDoc("browse", "Browser flow."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -537,7 +537,7 @@ description: |
             "browse/SKILL.md": skillDoc("browse", "Browser flow."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -551,14 +551,14 @@ description: |
             selectedLeafIds: [leafId],
         });
         expect(applied.ok).toBe(true);
-        expect(path.resolve(await fs.readlink(targetPath))).toBe(path.join(stateRoot, "source", "git", sourceId, "browse"));
+        expect(path.resolve(await fs.readlink(targetPath))).toBe(path.join(added.data.lock.checkoutPath, "browse"));
     });
     test("keeps external different-content skill and renames our projection instead", async () => {
         const repoPath = await createRepo(sandboxRoot, {
             "browse/SKILL.md": skillDoc("browse", "Managed browser flow."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -586,7 +586,7 @@ description: |
             "browse/SKILL.md": skillDoc("browse", "Managed browser flow."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -620,7 +620,7 @@ description: |
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(repoPath, { project: false });
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -632,7 +632,7 @@ description: |
             selectedLeafIds: [leafId],
         });
         expect(applied.ok).toBe(true);
-        await fs.rm(path.join(stateRoot, "source", "git", sourceId, "good"), {
+        await fs.rm(path.join(added.data.lock.checkoutPath, "good"), {
             recursive: true,
             force: true,
         });
@@ -747,7 +747,7 @@ description: |
             "browse/SKILL.md": skillDoc("browse", "Browser flow."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(`file://${repoPath}`);
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -863,7 +863,7 @@ description: |
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(`file://${repoPath}`);
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -886,14 +886,16 @@ description: |
         const repoPath = await createRepo(sandboxRoot, {
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
+        const remotePath = await createBareRemote(repoPath, sandboxRoot);
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(`file://${remotePath}`);
         expect(added.ok).toBe(true);
         await writeRepoFiles(repoPath, {
             "extra/SKILL.md": skillDoc("extra", "Extra description."),
         });
         git(repoPath, ["add", "."]);
         git(repoPath, ["commit", "-m", "add extra"]);
+        git(repoPath, ["push", "origin", "HEAD"]);
         const updated = await app.updateSources([added.ok ? added.data.manifest.id : ""]);
         expect(updated.ok).toBe(true);
         if (!updated.ok) {
@@ -905,8 +907,9 @@ description: |
         const repoPath = await createRepo(sandboxRoot, {
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
+        const remotePath = await createBareRemote(repoPath, sandboxRoot);
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(`file://${remotePath}`);
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -920,6 +923,7 @@ description: |
         await fs.rm(path.join(repoPath, "good"), { recursive: true, force: true });
         git(repoPath, ["add", "."]);
         git(repoPath, ["commit", "-m", "remove good"]);
+        git(repoPath, ["push", "origin", "HEAD"]);
         const updated = await app.updateSources([sourceId]);
         expect(updated.ok).toBe(true);
         if (!updated.ok) {
@@ -932,8 +936,9 @@ description: |
         const repoPath = await createRepo(sandboxRoot, {
             "good/SKILL.md": skillDoc("good", "Good description."),
         });
+        const remotePath = await createBareRemote(repoPath, sandboxRoot);
         const app = new SkillFlowApp();
-        const added = await app.addSource(repoPath);
+        const added = await app.addSource(`file://${remotePath}`);
         expect(added.ok).toBe(true);
         if (!added.ok) {
             return;
@@ -943,6 +948,7 @@ description: |
         });
         git(repoPath, ["add", "."]);
         git(repoPath, ["commit", "-m", "invalidate"]);
+        git(repoPath, ["push", "origin", "HEAD"]);
         const updated = await app.updateSources([added.data.manifest.id]);
         expect(updated.ok).toBe(true);
         if (!updated.ok) {
@@ -979,8 +985,13 @@ description: |
             enabledTargets: ["openclaw"],
             selectedLeafIds: [leafId],
         });
-        await writeRepoFiles(process.env.SKILL_FLOW_TARGET_OPENCLAW, {
-            ["good/SKILL.md"]: "# Good\nMutated copy.",
+        const lock = await app.store.readLock();
+        const deployment = lock.deployments.find((item) => item.sourceId === sourceId && item.leafId === leafId && item.target === "openclaw");
+        if (!deployment) {
+            throw new Error("expected deployment for openclaw");
+        }
+        await writeRepoFiles(path.dirname(deployment.targetPath), {
+            [`${path.basename(deployment.targetPath)}/SKILL.md`]: "# Good\nMutated copy.",
         });
         const doctor = await app.doctor();
         expect(doctor.ok).toBe(true);
@@ -989,6 +1000,19 @@ description: |
         }
         expect(doctor.data.issues.some((issue) => issue.code === "DRIFT_COPY")).toBe(true);
     });
+    test("bootstrap detects symlinked skills inside agent roots", async () => {
+        const app = new SkillFlowApp();
+        const externalRoot = path.join(sandboxRoot, "external-skill");
+        await writeRepoFiles(externalRoot, {
+            "SKILL.md": skillDoc("linked-skill", "Symlinked external skill."),
+        });
+        await fs.symlink(externalRoot, path.join(process.env.SKILL_FLOW_TARGET_CODEX, "linked-skill"), "junction");
+        await app.store.init();
+        const manifest = await app.store.readManifest();
+        const lock = await app.store.readLock();
+        const detected = await app.workspaceBootstrapService.detectUnmanagedExternalSkills(manifest, lock);
+        expect(detected.some((item) => item.displayName === "linked-skill")).toBe(true);
+    });
     test("keeps metadata warnings on valid skills", async () => {
         const repoPath = await createRepo(sandboxRoot, {
             "folder-name/SKILL.md": skillDoc("bad--name", "x".repeat(1025)),
@@ -1389,6 +1413,13 @@ async function createRepo(root, files) {
     git(repoPath, ["commit", "-m", "initial"]);
     return repoPath;
 }
+async function createBareRemote(repoPath, root) {
+    const remotePath = await fs.mkdtemp(path.join(root, "remote-"));
+    git(remotePath, ["init", "--bare"]);
+    git(repoPath, ["remote", "add", "origin", remotePath]);
+    git(repoPath, ["push", "-u", "origin", "HEAD"]);
+    return remotePath;
+}
 async function seedBuiltinCatalog(app) {
     for (const builtin of builtinGitSources.getBuiltinGitSources()) {
         await fs.mkdir(app.store.getCatalogCheckoutPath(deriveSourceId(builtin.locator)), {