@mulmoclaude/core 0.1.0

package/dist/workspace-setup/sync.d.ts

@@ -0,0 +1,94 @@
+export interface SyncPresetSkillsOptions {
+    /** Source directory: `<launcher>/server/workspace/skills-preset/`. */
+    sourceDir: string;
+    /** Destination directory:
+     *  `<workspaceRoot>/data/skills/catalog/preset/`. The catalog
+     *  half of the catalog-vs-active split — entries here are visible
+     *  to UI but NOT to Claude Code's prompt-time skill resolver. */
+    destDir: string;
+    /** Logger callbacks — kept injectable so tests don't need to
+     *  spin up the structured logger. The boot-side wrapper threads
+     *  these through to `log.info` / `log.warn`. */
+    onInfo?: (message: string, data?: Record<string, unknown>) => void;
+    onWarn?: (message: string, data?: Record<string, unknown>) => void;
+}
+export interface SyncPresetSkillsResult {
+    /** Slugs successfully copied (or refreshed) from source to dest. */
+    copied: string[];
+    /** Slugs removed from dest because they no longer exist in source.
+     *  Bounded to `mc-*` entries — user-authored slugs are never
+     *  considered for removal. */
+    removed: string[];
+    /** Source entries that failed validation (wrong prefix, missing
+     *  SKILL.md, etc.) and were skipped. Each entry is human-readable. */
+    skipped: string[];
+}
+/** Filesystem ops `_replaceSlugTree` depends on — injectable so the
+ *  mid-swap failure path can be regression-tested without real IO faults. */
+export interface SlugTreeFsOps {
+    copyTree: (src: string, dest: string) => void;
+    rename: (from: string, dest: string) => void;
+    remove: (target: string) => void;
+    exists: (target: string) => boolean;
+}
+/** Refresh one preset slot as a rollback-safe stage-and-swap. Wipe-and-replace
+ *  (not merge) so stale sibling assets — e.g. a schema.json dropped between
+ *  releases — don't linger; the catalog preset slot is launcher-owned, so user
+ *  edits there are not preserved across boots.
+ *
+ *  The live slot is never left without a recoverable copy:
+ *    1. Stage: copy the source into a temp sibling. A copy failure leaves the
+ *       existing preset untouched (temp dir removed).
+ *    2. Move the existing tree ASIDE to a backup (rename, not delete), so the
+ *       old contents survive even if the next step fails.
+ *    3. Move the staged copy into place. On failure, restore from the backup;
+ *       if even the restore fails, BOTH backup and staging are preserved for
+ *       manual recovery rather than deleted.
+ *    4. On success, drop the backup.
+ *
+ *  Exported with a `_` prefix only so the rename-failure-after-move path can be
+ *  regression-tested via the injected `fsOps`. Throws on failure (caller records
+ *  + skips). */
+export declare function _replaceSlugTree(sourceSlugDir: string, destSlugDir: string, fsOps?: SlugTreeFsOps): void;
+/** Copy every preset slug from `sourceDir` into `destDir` (the
+ *  preset slot under the catalog root), then remove any `mc-*`
+ *  entries in `destDir` that no longer have a source. The catalog
+ *  preset subdir is fully launcher-owned, so the `mc-*` prefix
+ *  check at destination is defence-in-depth: a stray non-preset
+ *  slug landing in `catalog/preset/` is unexpected, and we'd
+ *  rather skip it than silently delete a directory we don't
+ *  recognise. */
+export declare function syncPresetSkills(opts: SyncPresetSkillsOptions): SyncPresetSkillsResult;
+export interface SyncActivePresetSkillsOptions {
+    /** Source directory: `<launcher>/server/workspace/skills-preset/`. */
+    sourceDir: string;
+    /** Active skills directory: `<workspaceRoot>/.claude/skills/`. */
+    activeDir: string;
+    onInfo?: (message: string, data?: Record<string, unknown>) => void;
+    onWarn?: (message: string, data?: Record<string, unknown>) => void;
+}
+export interface SyncActivePresetSkillsResult {
+    /** Slugs whose active copy had at least one file overwritten. */
+    updated: string[];
+    /** Slugs whose active copy already matched the source — no-op. */
+    unchanged: string[];
+    /** Slugs that haven't been starred yet (no active dir present).
+     *  Listed for diagnostics; the function never auto-stars. */
+    notActive: string[];
+    /** Active `mc-*` slugs pruned because the launcher no longer ships a
+     *  source preset for them (a retired preset). Bounded to `mc-*` —
+     *  user-authored skills are never removed. */
+    removed: string[];
+    /** Per-slug failure messages (permission errors, etc.). */
+    skipped: string[];
+    /** Common timestamp suffix used for every backup file produced by
+     *  this run. Exposed so the boot-time log can point a user at the
+     *  exact glob to inspect. */
+    backupSuffix: string | null;
+}
+/** Refresh every already-starred `mc-*` preset's active copy in
+ *  `<workspaceRoot>/.claude/skills/<slug>/` to match the source.
+ *  Per-file diff with `.bak.<timestamp>` backup on overwrite. Slugs
+ *  that aren't starred yet are listed in `notActive` but never
+ *  auto-created. */
+export declare function syncActivePresetSkills(opts: SyncActivePresetSkillsOptions): SyncActivePresetSkillsResult;

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@mulmoclaude/core",
+  "version": "0.1.0",
+  "description": "Shared server-side core for MulmoClaude and MulmoTerminal — the always-shipped-together subsystems consolidated behind subpath exports so the two hosts can't drift. Server-only except the browser-safe ./whisper/client and ./workspace-setup/slug entries. All host specifics are injected.",
+  "type": "module",
+  "exports": {
+    "./collection": {
+      "types": "./dist/collection/index.d.ts",
+      "import": "./dist/collection/index.js",
+      "require": "./dist/collection/index.cjs",
+      "default": "./dist/collection/index.js"
+    },
+    "./collection/server": {
+      "types": "./dist/collection/server/index.d.ts",
+      "import": "./dist/collection/server/index.js",
+      "require": "./dist/collection/server/index.cjs",
+      "default": "./dist/collection/server/index.js"
+    },
+    "./collection/paths": {
+      "types": "./dist/collection/server/templatePath.d.ts",
+      "import": "./dist/collection/paths.js",
+      "require": "./dist/collection/paths.cjs",
+      "default": "./dist/collection/paths.js"
+    },
+    "./file-change": {
+      "types": "./dist/file-change/index.d.ts",
+      "import": "./dist/file-change/index.js",
+      "require": "./dist/file-change/index.cjs",
+      "default": "./dist/file-change/index.js"
+    },
+    "./notifier": {
+      "types": "./dist/notifier/index.d.ts",
+      "import": "./dist/notifier/index.js",
+      "require": "./dist/notifier/index.cjs",
+      "default": "./dist/notifier/index.js"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler/index.d.ts",
+      "import": "./dist/scheduler/index.js",
+      "require": "./dist/scheduler/index.cjs",
+      "default": "./dist/scheduler/index.js"
+    },
+    "./whisper": {
+      "types": "./dist/whisper/index.d.ts",
+      "import": "./dist/whisper/index.js",
+      "require": "./dist/whisper/index.cjs",
+      "default": "./dist/whisper/index.js"
+    },
+    "./whisper/client": {
+      "types": "./dist/whisper/client.d.ts",
+      "import": "./dist/whisper/client.js",
+      "require": "./dist/whisper/client.cjs",
+      "default": "./dist/whisper/client.js"
+    },
+    "./workspace-setup": {
+      "types": "./dist/workspace-setup/index.d.ts",
+      "import": "./dist/workspace-setup/index.js",
+      "default": "./dist/workspace-setup/index.js"
+    },
+    "./workspace-setup/slug": {
+      "types": "./dist/workspace-setup/slug.d.ts",
+      "import": "./dist/workspace-setup/slug.js",
+      "default": "./dist/workspace-setup/slug.js"
+    }
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && vite build -c vite.esm.config.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/**/test_*.ts"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@receptron/task-scheduler": "*",
+    "gui-chat-protocol": "^0.4.0"
+  },
+  "devDependencies": {
+    "@receptron/task-scheduler": "*",
+    "@types/node": "^26.0.1",
+    "gui-chat-protocol": "^0.4.0",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.13",
+    "vite-plugin-dts": "^5.0.0"
+  },
+  "license": "MIT"
+}