@synap-core/cli 1.8.0 → 1.11.0

package/dist/lib/skill-import.js

@@ -0,0 +1,203 @@
+/**
+ * Skill import — read standard SKILL.md skill directories and push them to the pod.
+ *
+ * Follows the Agent Skills open standard (agentskills.io): a skill is a DIRECTORY
+ * with a `SKILL.md` at its root (YAML frontmatter + markdown body) and optional
+ * nested files/subdirs for reference docs, examples, templates, and code. Every
+ * non-SKILL.md file becomes a linked document (the agent reads them on demand via
+ * get_document). This is the same format Claude Code, Codex, Gemini CLI, Copilot
+ * and others use.
+ *
+ * The pod stores them via POST /agent-skills/import: the SKILL.md body becomes
+ * the instruction skill, every other file becomes a linked document.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { hubPost } from "./hub-client.js";
+/**
+ * Minimal YAML frontmatter parser for SKILL.md. The frontmatter is intentionally
+ * simple (name, description, a flat `metadata:` block) so we avoid a YAML dep.
+ */
+function parseFrontmatter(raw) {
+    if (!raw.startsWith("---"))
+        return { fm: {}, body: raw };
+    const end = raw.indexOf("\n---", 3);
+    if (end === -1)
+        return { fm: {}, body: raw };
+    const fmBlock = raw.slice(3, end).trim();
+    const body = raw.slice(end + 4).replace(/^\s*\n/, "");
+    const fm = {};
+    for (const line of fmBlock.split("\n")) {
+        const m = line.match(/^\s*([a-zA-Z0-9_-]+):\s*(.*)$/);
+        if (m && m[2] !== "")
+            fm[m[1].trim()] = m[2].trim().replace(/^["']|["']$/g, "");
+    }
+    return { fm, body };
+}
+/**
+ * Recursively walk a directory, collecting every file (except SKILL.md) as a
+ * document. Preserves the relative path from `root` as the document title so the
+ * agent can reference files exactly as they appear in the skill (e.g.
+ * "reference/02-scoring-framework.md", "examples/q2-description-rewrites.md",
+ * "templates/abstract-review-builder.py").
+ *
+ * Binary files are skipped. Files over 512KB are skipped (anti-bloat guard).
+ */
+function collectAllDocuments(root, skillMdPath) {
+    const docs = [];
+    const MAX_BYTES = 512 * 1024;
+    function walk(dir, prefix) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory() || entry.isSymbolicLink()) {
+                // Follow symlink dirs; skip node_modules + .git
+                try {
+                    const stat = entry.isSymbolicLink() ? fs.statSync(full) : null;
+                    const isDir = entry.isDirectory() || (stat?.isDirectory() ?? false);
+                    if (isDir && !["node_modules", ".git"].includes(entry.name)) {
+                        walk(full, relPath);
+                    }
+                }
+                catch { /* broken symlink — skip */ }
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (full === skillMdPath)
+                continue; // body, not a document
+            if (entry.name.startsWith("."))
+                continue; // hidden files
+            try {
+                const stat = fs.statSync(full);
+                if (stat.size > MAX_BYTES)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            // Map extension → document type
+            const ext = path.extname(entry.name).toLowerCase();
+            let type = "markdown";
+            let language;
+            if (ext === ".md") {
+                type = "markdown";
+            }
+            else if (ext === ".py") {
+                type = "code";
+                language = "python";
+            }
+            else if (ext === ".js" || ext === ".ts") {
+                type = "code";
+                language = ext === ".ts" ? "typescript" : "javascript";
+            }
+            else if (ext === ".json") {
+                type = "code";
+                language = "json";
+            }
+            else if (ext === ".txt") {
+                type = "text";
+            }
+            else {
+                continue;
+            } // skip binary/unrecognized
+            let content;
+            try {
+                content = fs.readFileSync(full, "utf-8");
+            }
+            catch {
+                continue;
+            } // binary file detected at read time — skip
+            docs.push({ title: relPath, content, type, language });
+        }
+    }
+    walk(root, "");
+    return docs;
+}
+/** Parse a single SKILL.md skill directory into an import payload. */
+export function parseSkillDir(dir) {
+    const skillMd = path.join(dir, "SKILL.md");
+    if (!fs.existsSync(skillMd))
+        return null;
+    const raw = fs.readFileSync(skillMd, "utf-8");
+    const { fm, body } = parseFrontmatter(raw);
+    return {
+        slug: fm.name || path.basename(dir),
+        name: fm.name || path.basename(dir),
+        description: fm.description || "",
+        body: body.trim(),
+        autoLoad: fm.auto_load === "true",
+        documents: collectAllDocuments(dir, skillMd),
+    };
+}
+/** Find every skill directory (one containing SKILL.md) under a root, one level deep. */
+export function discoverSkillDirs(root) {
+    if (!fs.existsSync(root))
+        return [];
+    if (fs.existsSync(path.join(root, "SKILL.md")))
+        return [root];
+    const out = [];
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+        const full = path.join(root, entry.name);
+        const isDir = entry.isDirectory() ||
+            (entry.isSymbolicLink() && fs.statSync(full).isDirectory());
+        if (isDir && fs.existsSync(path.join(full, "SKILL.md")))
+            out.push(full);
+    }
+    return out;
+}
+/** Import a parsed skill into the pod via POST /agent-skills/import. */
+export async function importSkill(parsed, userId, cfg) {
+    try {
+        const res = (await hubPost("/agent-skills/import", {
+            userId,
+            skill: {
+                slug: parsed.slug,
+                name: parsed.name,
+                description: parsed.description,
+                body: parsed.body,
+                autoLoad: parsed.autoLoad,
+            },
+            documents: parsed.documents,
+        }, cfg));
+        if (res.error && /already exists/i.test(res.error)) {
+            return { slug: parsed.slug, status: "exists", docs: 0 };
+        }
+        if (res.skill) {
+            return {
+                slug: parsed.slug,
+                status: "imported",
+                docs: res.documents?.length ?? 0,
+            };
+        }
+        return {
+            slug: parsed.slug,
+            status: "error",
+            docs: 0,
+            error: res.error ?? "unknown",
+        };
+    }
+    catch (err) {
+        // Idempotent re-seed: the hub returns HTTP 409 ("already exists") when the
+        // skill slug is present. hubPost throws on non-2xx, so the 409 lands here —
+        // treat it as a no-op success, not an error.
+        const msg = err instanceof Error ? err.message : String(err);
+        if (/already exists/i.test(msg) || /\b409\b/.test(msg)) {
+            return { slug: parsed.slug, status: "exists", docs: 0 };
+        }
+        return {
+            slug: parsed.slug,
+            status: "error",
+            docs: 0,
+            error: msg,
+        };
+    }
+}
+//# sourceMappingURL=skill-import.js.map

package/dist/lib/skill-import.js.map

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

package/dist/lib/skills-installer.d.ts

@@ -2,17 +2,28 @@
  * Skill installer — copies the synap skill tree into a target's skills directory.
  *
  * Source resolution order:
- *   1. $SYNAP_SKILLS_DIR (explicit override)
- *   2. adjacent ../synap-backend/skills/ (monorepo dev mode)
- *   3. bundled skills/ inside this package (production / published npm)
- *   4. fetch from a published tarball (fallback — not yet implemented)
+ *   1. $SYNAP_SKILLS_DIR (explicit override) or an adjacent ../synap-backend/skills/
+ *      checkout (monorepo dev mode) — both are local disk, dev escape hatches.
+ *   2. the connected pod — GET /api/hub/skills/system (pod-first: production
+ *      users get whatever skill packages their pod actually serves, not a
+ *      snapshot baked into this CLI's npm release).
+ *   3. bundled skills/ inside this package (production / published npm,
+ *      offline, or pod unreachable).
  *
  * If none resolve, prints a manual install command and returns false.
  */
-export declare const SKILL_NAMES: readonly ["synap", "synap-schema", "synap-ui", "autonomous-dev"];
+/** Last-resort constant — only used when no manifest.json can be found on
+ *  disk (dev or bundled) AND the pod is unreachable/unconfigured. */
+export declare const SKILL_NAMES: readonly ["synap", "synap-schema", "synap-ui"];
 export type SkillName = (typeof SKILL_NAMES)[number];
+/**
+ * Baseline skills are safe to install into every agent context. Workflow
+ * packages are intentionally loaded only when the target/user asks for them;
+ * installing them by default turns progressive teaching back into prompt bulk.
+ */
+export declare function getDeliverableSkills(): string[];
 export interface InstallOpts {
     destDir: string;
-    skills: readonly string[];
+    skills?: readonly string[];
 }
 export declare function installSkills(opts: InstallOpts): Promise<boolean>;

package/dist/lib/skills-installer.js

@@ -2,10 +2,13 @@
  * Skill installer — copies the synap skill tree into a target's skills directory.
  *
  * Source resolution order:
- *   1. $SYNAP_SKILLS_DIR (explicit override)
- *   2. adjacent ../synap-backend/skills/ (monorepo dev mode)
- *   3. bundled skills/ inside this package (production / published npm)
- *   4. fetch from a published tarball (fallback — not yet implemented)
+ *   1. $SYNAP_SKILLS_DIR (explicit override) or an adjacent ../synap-backend/skills/
+ *      checkout (monorepo dev mode) — both are local disk, dev escape hatches.
+ *   2. the connected pod — GET /api/hub/skills/system (pod-first: production
+ *      users get whatever skill packages their pod actually serves, not a
+ *      snapshot baked into this CLI's npm release).
+ *   3. bundled skills/ inside this package (production / published npm,
+ *      offline, or pod unreachable).
  *
  * If none resolve, prints a manual install command and returns false.
  */
@@ -13,20 +16,129 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { log } from "../utils/logger.js";
-export const SKILL_NAMES = ["synap", "synap-schema", "synap-ui", "autonomous-dev"];
+import { resolveHubConfig } from "./hub-client.js";
+/** Last-resort constant — only used when no manifest.json can be found on
+ *  disk (dev or bundled) AND the pod is unreachable/unconfigured. */
+export const SKILL_NAMES = ["synap", "synap-schema", "synap-ui"];
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+/**
+ * Baseline skills are safe to install into every agent context. Workflow
+ * packages are intentionally loaded only when the target/user asks for them;
+ * installing them by default turns progressive teaching back into prompt bulk.
+ */
+export function getDeliverableSkills() {
+    const srcDir = resolveDiskSource();
+    if (srcDir) {
+        const manifestPath = path.join(srcDir, "manifest.json");
+        try {
+            const raw = fs.readFileSync(manifestPath, "utf8");
+            const manifest = JSON.parse(raw);
+            const baseline = Array.isArray(manifest.baseline) ? manifest.baseline : [];
+            if (baseline.length > 0)
+                return baseline;
+        }
+        catch {
+            // manifest absent or malformed — fall through to hardcoded list
+        }
+    }
+    return [...SKILL_NAMES];
+}
 export async function installSkills(opts) {
-    const srcDir = resolveSkillsSource();
-    if (!srcDir) {
-        log.warn("Could not locate skills source.");
-        log.dim("Set SYNAP_SKILLS_DIR to the folder containing synap/, synap-schema/, synap-ui/");
-        log.dim("Or clone: git clone https://github.com/Synap-core/synap.git");
-        log.dim(`Then copy synap/synap-backend/skills/* → ${opts.destDir}/`);
-        return false;
+    // 1. Local disk source — explicit override or monorepo dev checkout.
+    const diskSrc = resolveDiskSource();
+    if (diskSrc) {
+        log.dim("Skill source: local disk");
+        return installFromDisk(diskSrc, opts);
+    }
+    // 2. The connected pod.
+    const podPackages = await fetchSkillsFromPod();
+    if (podPackages && podPackages.length > 0) {
+        const names = opts.skills ?? getDeliverableSkills();
+        const installed = installFromPackages(podPackages, names, opts.destDir);
+        if (installed > 0) {
+            log.dim("Skill source: pod (/api/hub/skills/system)");
+            return true;
+        }
+    }
+    // 3. Bundled fallback inside this package.
+    const bundledSrc = resolveBundledSource();
+    if (bundledSrc) {
+        log.dim("Skill source: bundled fallback");
+        return installFromDisk(bundledSrc, opts);
+    }
+    log.warn("Could not locate skills source.");
+    log.dim("Set SYNAP_SKILLS_DIR to the folder containing synap/, synap-schema/, synap-ui/");
+    log.dim("Or connect a pod: synap pods add");
+    log.dim("Or clone: git clone https://github.com/Synap-core/synap.git");
+    log.dim(`Then copy synap/synap-backend/skills/* → ${opts.destDir}/`);
+    return false;
+}
+/** Fetch the pod's system skill packages over Hub Protocol. Returns null on
+ *  any failure (no pod configured, unreachable, non-2xx, bad payload) so
+ *  installSkills() can fall through to the bundled tier gracefully. */
+async function fetchSkillsFromPod() {
+    try {
+        const cfg = await resolveHubConfig();
+        if (!cfg.podUrl || !cfg.apiKey)
+            return null;
+        const res = await fetch(`${cfg.podUrl}/api/hub/skills/system?scope=full`, {
+            headers: { Authorization: `Bearer ${cfg.apiKey}` },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        if (!Array.isArray(data))
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/** Write the requested packages' files to destDir, same on-disk layout as
+ *  installFromDisk (destDir/<slug>/<file>). Returns count installed. */
+function installFromPackages(packages, names, destDir) {
+    let installed = 0;
+    for (const name of names) {
+        const pkg = packages.find((p) => p.slug === name);
+        if (!pkg || pkg.files.length === 0) {
+            log.warn(`Skill '${name}' not found on pod (skipping)`);
+            continue;
+        }
+        const dst = resolveWithin(destDir, name);
+        if (!dst) {
+            log.warn(`Skill '${name}' has an unsafe destination (skipping)`);
+            continue;
+        }
+        fs.mkdirSync(dst, { recursive: true });
+        for (const file of pkg.files) {
+            const filePath = resolveWithin(dst, file.path);
+            if (!filePath) {
+                log.warn(`Skill '${name}' contains unsafe file path '${file.path}' (skipping)`);
+                continue;
+            }
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, file.content, "utf8");
+        }
+        installed++;
+        log.success(`Installed ${name} → ${shortenHome(dst)}`);
     }
+    return installed;
+}
+/** Resolve a pod-supplied package/file name without allowing directory escape. */
+function resolveWithin(root, relativePath) {
+    if (!relativePath || path.isAbsolute(relativePath))
+        return null;
+    const rootPath = path.resolve(root);
+    const target = path.resolve(rootPath, relativePath);
+    return target.startsWith(rootPath + path.sep) ? target : null;
+}
+function installFromDisk(srcDir, opts) {
+    const skills = opts.skills ?? getDeliverableSkills();
     let installed = 0;
-    for (const name of opts.skills) {
+    for (const name of skills) {
         const src = path.join(srcDir, name);
         if (!fs.existsSync(src)) {
             log.warn(`Skill '${name}' not found in source (skipping)`);
@@ -43,14 +155,14 @@ export async function installSkills(opts) {
     }
     return true;
 }
-function resolveSkillsSource() {
-    // 1. Explicit override
+/** Explicit override ($SYNAP_SKILLS_DIR) or the adjacent ../synap-backend/skills/
+ *  checkout (monorepo dev mode). Both are local-disk, dev-only escape hatches. */
+function resolveDiskSource() {
     const override = process.env.SYNAP_SKILLS_DIR;
     if (override && fs.existsSync(override)) {
         return override;
     }
-    // 2. Monorepo dev mode — ../synap-backend/skills/ relative to CLI source
-    //    __dirname is .../synap-cli/dist/lib OR .../synap-cli/src/lib
+    // __dirname is .../synap-cli/dist/lib OR .../synap-cli/src/lib
     const candidates = [
         path.resolve(__dirname, "..", "..", "..", "synap-backend", "skills"),
         path.resolve(__dirname, "..", "..", "..", "..", "synap-backend", "skills"),
@@ -60,12 +172,14 @@ function resolveSkillsSource() {
             return c;
         }
     }
-    // 3. Bundled inside the package — synap-cli/skills/
+    return null;
+}
+/** Bundled inside the package — synap-cli/skills/ (production / published npm). */
+function resolveBundledSource() {
     const bundled = path.resolve(__dirname, "..", "..", "skills");
     if (fs.existsSync(path.join(bundled, "synap", "SKILL.md"))) {
         return bundled;
     }
-    // 4. TODO: remote fetch fallback
     return null;
 }
 function copyDir(src, dst) {

package/dist/lib/skills-installer.js.map

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

package/dist/lib/suite.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Suite detection — data-driven, not a hardcoded slug allowlist.
+ * =============================================================
+ *
+ * A SUITE is a headline package that installs a whole operating core by
+ * composing/requiring several constituent workspaces (e.g. `enterprise-os`,
+ * `the-arch`). It is authored in the template YAML's `meta.tags` and mirrored
+ * onto every catalog surface, so "is this a suite?" is a first-class signal
+ * rather than the `COMPANY_SUITE` / `PRIVATE_SUITE` slug constants the CLI used
+ * to hand-maintain.
+ *
+ * This is a MIRROR, not a second source of truth. The SSOT is
+ * `@synap-core/marketplace` (`SUITE_TAG` / `isSuite` in `src/types.ts`). That
+ * package is a React feature package with no build output and a barrel that
+ * drags in `react` / JSX, so a Node CLI compiled with `tsc` cannot import it
+ * without breaking its build. The value is a single string — mirrored here the
+ * same way `marketplace/types.ts` itself mirrors the CP's schema vocabulary.
+ */
+/** The tag that marks a package as a suite. SSOT: `@synap-core/marketplace`. */
+export declare const SUITE_TAG: "suite";
+/**
+ * A suite is identified by the presence of `SUITE_TAG` in its tags. Works on any
+ * catalog shape carrying tags — a bundled `CatalogEntry`, a `RemoteEntry`, or a
+ * raw `{ tags }` projection.
+ */
+export declare function isSuite(entry: {
+    tags?: readonly string[] | null;
+}): boolean;

package/dist/lib/suite.js

@@ -0,0 +1,29 @@
+/**
+ * Suite detection — data-driven, not a hardcoded slug allowlist.
+ * =============================================================
+ *
+ * A SUITE is a headline package that installs a whole operating core by
+ * composing/requiring several constituent workspaces (e.g. `enterprise-os`,
+ * `the-arch`). It is authored in the template YAML's `meta.tags` and mirrored
+ * onto every catalog surface, so "is this a suite?" is a first-class signal
+ * rather than the `COMPANY_SUITE` / `PRIVATE_SUITE` slug constants the CLI used
+ * to hand-maintain.
+ *
+ * This is a MIRROR, not a second source of truth. The SSOT is
+ * `@synap-core/marketplace` (`SUITE_TAG` / `isSuite` in `src/types.ts`). That
+ * package is a React feature package with no build output and a barrel that
+ * drags in `react` / JSX, so a Node CLI compiled with `tsc` cannot import it
+ * without breaking its build. The value is a single string — mirrored here the
+ * same way `marketplace/types.ts` itself mirrors the CP's schema vocabulary.
+ */
+/** The tag that marks a package as a suite. SSOT: `@synap-core/marketplace`. */
+export const SUITE_TAG = "suite";
+/**
+ * A suite is identified by the presence of `SUITE_TAG` in its tags. Works on any
+ * catalog shape carrying tags — a bundled `CatalogEntry`, a `RemoteEntry`, or a
+ * raw `{ tags }` projection.
+ */
+export function isSuite(entry) {
+    return entry.tags?.includes(SUITE_TAG) ?? false;
+}
+//# sourceMappingURL=suite.js.map

package/dist/lib/suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.js","sourceRoot":"","sources":["../../src/lib/suite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,SAAS,GAAG,OAAgB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAA0C;IAChE,OAAO,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;AAClD,CAAC"}

package/dist/lib/superwhisper-import.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Superwhisper store-first import — pair meta.json + output.wav into pod-wide
+ * notes with optional audio provenance. No AI structure on the WAV (IS STT is
+ * a stub); transcript comes from Superwhisper's meta.
+ *
+ * Idempotency: local ledger (~/.synap/import-ledger/superwhisper.json) maps
+ * recordingId → entityId so resume/re-run skips completed units. Server-side
+ * external_links land in Wave 3; ledger is the v1 resume story.
+ */
+export interface SuperwhisperImportOpts {
+    dryRun?: boolean;
+    yes?: boolean;
+    json?: boolean;
+    withAudio?: boolean;
+    /** Max units to process (for probes). */
+    limit?: number;
+    /** Max concurrent unit uploads (default 2). */
+    concurrency?: number;
+    /** Skip units already in the local ledger. Default true. */
+    resume?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export interface SuperwhisperUnit {
+    recordingId: string;
+    dir: string;
+    metaPath: string;
+    wavPath: string | null;
+    wavSize: number;
+    datetime?: string;
+    language?: string;
+    duration?: number;
+    modeName?: string;
+    transcript: string;
+    title: string;
+}
+/** Expand a Superwhisper recordings root (or a single clip dir) into units. */
+export declare function collectSuperwhisperUnits(root: string): SuperwhisperUnit[];
+/** Run store-first Superwhisper import for one or more roots. */
+export declare function importSuperwhisperStoreFirst(roots: string[], opts: SuperwhisperImportOpts): Promise<void>;