@synap-core/cli 1.7.0 → 1.10.0

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";
+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>;