@cleocode/adapters 2026.5.26 → 2026.5.27

package/dist/providers/shared/paths.d.ts

@@ -1,32 +1,14 @@
 /**
- * Path utilities for adapter install providers.
+ * Adapter-shared path helpers.
  *
- * These helpers mirror the equivalent functions in `@cleocode/core/paths`
- * but are duplicated here to avoid a circular dependency
- * (`@cleocode/core` → `@cleocode/adapters` → `@cleocode/core`).
+ * Historically this module hand-rolled `getCleoTemplatesTildePath` to avoid a
+ * circular `core ↔ adapters` import. With the introduction of `@cleocode/paths`
+ * — a zero-dep leaf package consumed by core, adapters, worktree, brain, and
+ * caamp — that workaround is no longer needed: every package imports from the
+ * SSoT directly.
  *
- * @remarks
- * Keep the implementation in sync with `getCleoTemplatesTildePath` in
- * `packages/core/src/paths.ts` if the logic ever changes.
- *
- * @task T916
- */
-/**
- * Get the CLEO templates directory as a tilde-prefixed path for use in
- * `@` references (AGENTS.md, CLAUDE.md, etc.). Cross-platform: replaces
- * the user's home directory with `~` so the reference works when loaded
- * by LLM providers that resolve `~` at runtime.
- *
- * @returns Tilde-prefixed path like `"~/.local/share/cleo/templates"` on Linux,
- *   `"~/Library/Application Support/cleo/templates"` on macOS, etc.
- *
- * @example
- * ```typescript
- * const ref = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
- * // "@~/.local/share/cleo/templates/CLEO-INJECTION.md"  (Linux)
- * ```
- *
- * @task T916
+ * @task T916 (original duplicate)
+ * @task T1886 (consolidated into @cleocode/paths SSoT)
  */
-export declare function getCleoTemplatesTildePath(): string;
+export { getCleoTemplatesTildePath } from '@cleocode/paths';
 //# sourceMappingURL=paths.d.ts.map

package/dist/providers/shared/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwCH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CASlD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.5.26",
+  "version": "2026.5.27",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -15,8 +15,9 @@
     "@ai-sdk/anthropic": "^3.0.69",
     "@ai-sdk/openai": "^2.0.53",
     "ai": "^6.0.168",
-    "@cleocode/caamp": "2026.5.26",
-    "@cleocode/contracts": "2026.5.26"
+    "@cleocode/caamp": "2026.5.27",
+    "@cleocode/contracts": "2026.5.27",
+    "@cleocode/paths": "2026.5.27"
   },
   "license": "MIT",
   "engines": {
@@ -29,7 +30,7 @@
   "devDependencies": {
     "@types/node": "^22.19.15",
     "vitest": "^4.1.4",
-    "@cleocode/playbooks": "2026.5.26"
+    "@cleocode/playbooks": "2026.5.27"
   },
   "repository": {
     "type": "git",

package/src/providers/shared/paths.ts

@@ -1,79 +1,14 @@
 /**
- * Path utilities for adapter install providers.
+ * Adapter-shared path helpers.
  *
- * These helpers mirror the equivalent functions in `@cleocode/core/paths`
- * but are duplicated here to avoid a circular dependency
- * (`@cleocode/core` → `@cleocode/adapters` → `@cleocode/core`).
+ * Historically this module hand-rolled `getCleoTemplatesTildePath` to avoid a
+ * circular `core ↔ adapters` import. With the introduction of `@cleocode/paths`
+ * — a zero-dep leaf package consumed by core, adapters, worktree, brain, and
+ * caamp — that workaround is no longer needed: every package imports from the
+ * SSoT directly.
  *
- * @remarks
- * Keep the implementation in sync with `getCleoTemplatesTildePath` in
- * `packages/core/src/paths.ts` if the logic ever changes.
- *
- * @task T916
+ * @task T916 (original duplicate)
+ * @task T1886 (consolidated into @cleocode/paths SSoT)
  */
 
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-
-/**
- * Resolve the XDG / OS-appropriate global CLEO data directory.
- *
- * Respects `CLEO_HOME` env var; otherwise uses the platform default:
- * - Linux:   `~/.local/share/cleo`
- * - macOS:   `~/Library/Application Support/cleo`
- * - Windows: `%LOCALAPPDATA%\cleo\Data` (approximate)
- *
- * @returns Absolute path to the CLEO data directory
- *
- * @internal
- */
-function getAdapterCleoHome(): string {
-  if (process.env['CLEO_HOME']) {
-    return process.env['CLEO_HOME'];
-  }
-  const home = homedir();
-  if (process.platform === 'darwin') {
-    return join(home, 'Library', 'Application Support', 'cleo');
-  }
-  if (process.platform === 'win32') {
-    const localAppData = process.env['LOCALAPPDATA'];
-    if (localAppData) {
-      return join(localAppData, 'cleo', 'Data');
-    }
-    return join(home, 'AppData', 'Local', 'cleo', 'Data');
-  }
-  // Linux / XDG
-  const xdgData = process.env['XDG_DATA_HOME'];
-  if (xdgData) {
-    return join(xdgData, 'cleo');
-  }
-  return join(home, '.local', 'share', 'cleo');
-}
-
-/**
- * Get the CLEO templates directory as a tilde-prefixed path for use in
- * `@` references (AGENTS.md, CLAUDE.md, etc.). Cross-platform: replaces
- * the user's home directory with `~` so the reference works when loaded
- * by LLM providers that resolve `~` at runtime.
- *
- * @returns Tilde-prefixed path like `"~/.local/share/cleo/templates"` on Linux,
- *   `"~/Library/Application Support/cleo/templates"` on macOS, etc.
- *
- * @example
- * ```typescript
- * const ref = `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`;
- * // "@~/.local/share/cleo/templates/CLEO-INJECTION.md"  (Linux)
- * ```
- *
- * @task T916
- */
-export function getCleoTemplatesTildePath(): string {
-  const absPath = join(getAdapterCleoHome(), 'templates');
-  const home = homedir();
-  if (absPath.startsWith(home)) {
-    // Always use forward slash after tilde for cross-platform @-reference resolution
-    const relative = absPath.slice(home.length).replace(/\\/g, '/');
-    return `~${relative}`;
-  }
-  return absPath;
-}
+export { getCleoTemplatesTildePath } from '@cleocode/paths';