prjct-cli 0.37.1 → 0.40.0

package/core/services/skill-lock.ts

@@ -0,0 +1,132 @@
+/**
+ * Skill Lock File Service
+ *
+ * Manages a lock file that tracks remotely-installed skills for
+ * reproducibility and update detection.
+ *
+ * Lock file location: ~/.prjct-cli/skills/.skill-lock.json
+ *
+ * @version 1.0.0
+ */
+
+import fs from 'fs/promises'
+import path from 'path'
+import os from 'os'
+
+// =============================================================================
+// Types
+// =============================================================================
+
+export interface SkillLockSource {
+  type: 'github' | 'local' | 'registry'
+  url: string
+  sha?: string
+}
+
+export interface SkillLockEntry {
+  name: string
+  source: SkillLockSource
+  installedAt: string
+  filePath: string
+}
+
+export interface SkillLockFile {
+  version: 1
+  generatedAt: string
+  skills: Record<string, SkillLockEntry>
+}
+
+// =============================================================================
+// Lock File Service
+// =============================================================================
+
+const LOCK_FILE_NAME = '.skill-lock.json'
+
+function getLockFilePath(): string {
+  return path.join(os.homedir(), '.prjct-cli', 'skills', LOCK_FILE_NAME)
+}
+
+function createEmptyLockFile(): SkillLockFile {
+  return {
+    version: 1,
+    generatedAt: new Date().toISOString(),
+    skills: {},
+  }
+}
+
+/**
+ * Read the lock file, returning an empty lock file if it doesn't exist
+ */
+async function read(): Promise<SkillLockFile> {
+  try {
+    const content = await fs.readFile(getLockFilePath(), 'utf-8')
+    return JSON.parse(content) as SkillLockFile
+  } catch {
+    return createEmptyLockFile()
+  }
+}
+
+/**
+ * Write the lock file to disk
+ */
+async function write(lockFile: SkillLockFile): Promise<void> {
+  const lockPath = getLockFilePath()
+  await fs.mkdir(path.dirname(lockPath), { recursive: true })
+  lockFile.generatedAt = new Date().toISOString()
+  await fs.writeFile(lockPath, JSON.stringify(lockFile, null, 2), 'utf-8')
+}
+
+/**
+ * Add or update a skill entry in the lock file
+ */
+async function addEntry(entry: SkillLockEntry): Promise<void> {
+  const lockFile = await read()
+  lockFile.skills[entry.name] = entry
+  await write(lockFile)
+}
+
+/**
+ * Remove a skill entry from the lock file
+ */
+async function removeEntry(name: string): Promise<boolean> {
+  const lockFile = await read()
+  if (!(name in lockFile.skills)) return false
+  delete lockFile.skills[name]
+  await write(lockFile)
+  return true
+}
+
+/**
+ * Get a single skill entry
+ */
+async function getEntry(name: string): Promise<SkillLockEntry | null> {
+  const lockFile = await read()
+  return lockFile.skills[name] || null
+}
+
+/**
+ * Get all entries
+ */
+async function getAll(): Promise<Record<string, SkillLockEntry>> {
+  const lockFile = await read()
+  return lockFile.skills
+}
+
+/**
+ * Get the lock file path (for display purposes)
+ */
+function getPath(): string {
+  return getLockFilePath()
+}
+
+export const skillLock = {
+  read,
+  write,
+  addEntry,
+  removeEntry,
+  getEntry,
+  getAll,
+  getPath,
+}
+
+export default skillLock

package/core/services/skill-service.ts

@@ -83,9 +83,9 @@ class SkillService {
   /**
    * Get all skill directories in order of priority
    */
-  private getSkillDirs(projectPath?: string, provider?: AIProviderName): Array<{ dir: string; source: Skill['source']; isProviderSkill?: boolean }> {
+  private getSkillDirs(projectPath?: string, provider?: AIProviderName): Array<{ dir: string; source: Skill['source'] }> {
     const homeDir = process.env.HOME || process.env.USERPROFILE || '~'
-    const dirs: Array<{ dir: string; source: Skill['source']; isProviderSkill?: boolean }> = []
+    const dirs: Array<{ dir: string; source: Skill['source'] }> = []
 
     // Project skills (highest priority)
     if (projectPath) {
@@ -96,11 +96,11 @@ class SkillService {
     // Both use SKILL.md format, so skills are compatible
     if (provider) {
       const providerDir = provider === 'gemini' ? '.gemini' : '.claude'
-      dirs.push({ dir: path.join(homeDir, providerDir, 'skills'), source: 'global', isProviderSkill: true })
+      dirs.push({ dir: path.join(homeDir, providerDir, 'skills'), source: 'global' })
     } else {
       // Check both providers if no specific one is set
-      dirs.push({ dir: path.join(homeDir, '.claude', 'skills'), source: 'global', isProviderSkill: true })
-      dirs.push({ dir: path.join(homeDir, '.gemini', 'skills'), source: 'global', isProviderSkill: true })
+      dirs.push({ dir: path.join(homeDir, '.claude', 'skills'), source: 'global' })
+      dirs.push({ dir: path.join(homeDir, '.gemini', 'skills'), source: 'global' })
     }
 
     // prjct global skills
@@ -123,6 +123,9 @@ class SkillService {
       const id = fileToSkillId(filePath)
       const name = (metadata.name as string) || id
 
+      // Extract _prjct source tracking metadata if present
+      const prjctMeta = metadata._prjct as Record<string, unknown> | undefined
+
       return {
         id,
         name,
@@ -136,6 +139,12 @@ class SkillService {
           agent: metadata.agent as string,
           tags: metadata.tags as string[],
           version: metadata.version as string,
+          category: metadata.category as string,
+          author: metadata.author as string,
+          sourceUrl: prjctMeta?.sourceUrl as string,
+          sourceType: prjctMeta?.sourceType as SkillMetadata['sourceType'],
+          installedAt: prjctMeta?.installedAt as string,
+          sha: prjctMeta?.sha as string,
         },
       }
     } catch (_error) {
@@ -151,27 +160,27 @@ class SkillService {
     this.skills.clear()
     const dirs = this.getSkillDirs(projectPath, provider)
 
-    for (const { dir, source, isProviderSkill } of dirs) {
+    for (const { dir, source } of dirs) {
       try {
-        if (isProviderSkill) {
-          // Provider skills use SKILL.md in subdirectories
-          // e.g., ~/.claude/skills/my-skill/SKILL.md
-          const skillDirs = await glob('*/SKILL.md', { cwd: dir, absolute: true })
-          for (const file of skillDirs) {
-            const skill = await this.loadSkill(file, source)
-            if (skill && !this.skills.has(skill.id)) {
-              this.skills.set(skill.id, skill)
-            }
+        // Check both patterns in ALL skill directories:
+        // 1. Flat files: {dir}/{name}.md
+        // 2. Subdirectories: {dir}/{name}/SKILL.md (ecosystem standard)
+        const flatFiles = await glob('*.md', { cwd: dir, absolute: true })
+        const subdirFiles = await glob('*/SKILL.md', { cwd: dir, absolute: true })
+
+        // Load subdirectory skills first (ecosystem standard takes priority within same dir)
+        for (const file of subdirFiles) {
+          const skill = await this.loadSkill(file, source)
+          if (skill && !this.skills.has(skill.id)) {
+            this.skills.set(skill.id, skill)
           }
-        } else {
-          // Regular .md files in directory
-          const files = await glob('*.md', { cwd: dir, absolute: true })
-          for (const file of files) {
-            const skill = await this.loadSkill(file, source)
-            if (skill && !this.skills.has(skill.id)) {
-              // Don't override higher priority skills
-              this.skills.set(skill.id, skill)
-            }
+        }
+
+        // Then flat files (don't override subdirectory version)
+        for (const file of flatFiles) {
+          const skill = await this.loadSkill(file, source)
+          if (skill && !this.skills.has(skill.id)) {
+            this.skills.set(skill.id, skill)
           }
         }
       } catch (_error) {
@@ -256,6 +265,7 @@ class SkillService {
       project: [],
       global: [],
       builtin: [],
+      remote: [],
     }
 
     for (const skill of skills) {

package/core/types/provider.ts

@@ -5,19 +5,22 @@
  * - Claude Code (CLI)
  * - Gemini CLI (CLI)
  * - Cursor IDE (GUI, project-level config)
+ * - Windsurf IDE (GUI, project-level config)
  *
  * Key discovery: Skills use identical SKILL.md format for CLI providers.
  * Cursor uses .mdc files with frontmatter for rules.
+ * Windsurf uses .md files with YAML frontmatter for rules.
  *
  * @see https://geminicli.com/docs/cli/gemini-md/
  * @see https://geminicli.com/docs/cli/skills/
  * @see https://cursor.com/docs/context/rules
+ * @see https://docs.windsurf.com/windsurf/cascade/memories
  */
 
 /**
  * Supported AI provider names
  */
-export type AIProviderName = 'claude' | 'gemini' | 'cursor'
+export type AIProviderName = 'claude' | 'gemini' | 'cursor' | 'antigravity' | 'windsurf'
 
 /**
  * Command format for each provider
@@ -122,6 +125,20 @@ export interface CursorProjectDetection {
   projectRoot?: string
 }
 
+/**
+ * Result of Windsurf project detection
+ */
+export interface WindsurfProjectDetection {
+  /** Whether .windsurf/ directory exists in project */
+  detected: boolean
+
+  /** Whether prjct router is installed */
+  routerInstalled: boolean
+
+  /** Project root path */
+  projectRoot?: string
+}
+
 /**
  * Provider-aware branding configuration
  */

package/core/types/services.ts

@@ -28,6 +28,11 @@ export interface SkillMetadata {
   version?: string
   category?: string
   author?: string
+  // Ecosystem compatibility fields
+  sourceUrl?: string
+  sourceType?: 'github' | 'local' | 'builtin' | 'registry'
+  installedAt?: string
+  sha?: string
 }
 
 export interface Skill {
@@ -35,7 +40,7 @@ export interface Skill {
   name: string
   description: string
   content: string
-  source: 'project' | 'global' | 'builtin'
+  source: 'project' | 'global' | 'builtin' | 'remote'
   filePath: string
   metadata: SkillMetadata
   path?: string