locus-product-planning 1.1.0 → 1.2.1

package/dist/{lib/skills-core.d.ts → index.d.cts}

@@ -1,8 +1,22 @@
+import { Plugin } from '@opencode-ai/plugin';
+
 /**
  * Skills Core Library
  * Shared utilities for skill discovery, loading, and management
  */
-export interface SkillMetadata {
+/**
+ * Get the package root directory (parent of dist/).
+ */
+declare function getPackageRoot(): string;
+/**
+ * Get the locus skills directory.
+ */
+declare function getLocusSkillsDir(): string;
+/**
+ * Get the locus agents directory.
+ */
+declare function getLocusAgentsDir(): string;
+interface SkillMetadata {
     name: string;
     description: string;
     license?: string;
@@ -21,7 +35,7 @@ export interface SkillMetadata {
     };
     [key: string]: string | Record<string, string | undefined> | undefined;
 }
-export interface SkillInfo {
+interface SkillInfo {
     path: string;
     skillFile: string;
     name: string;
@@ -32,14 +46,14 @@ export interface SkillInfo {
     council?: string;
     version?: string;
 }
-export interface AgentInfo {
+interface AgentInfo {
     path: string;
     name: string;
     description: string;
     model?: string;
     category: string;
 }
-export interface ResolvedSkill {
+interface ResolvedSkill {
     skillFile: string;
     sourceType: 'project' | 'personal' | 'locus';
     skillPath: string;
@@ -61,19 +75,19 @@ export interface ResolvedSkill {
  *   tier: developer
  * ---
  */
-export declare function extractFrontmatter(filePath: string): SkillMetadata;
+declare function extractFrontmatter(filePath: string): SkillMetadata;
 /**
  * Strip YAML frontmatter from content, returning just the body.
  */
-export declare function stripFrontmatter(content: string): string;
+declare function stripFrontmatter(content: string): string;
 /**
  * Find all SKILL.md files in a directory recursively.
  */
-export declare function findSkillsInDir(dir: string, sourceType: 'project' | 'personal' | 'locus', maxDepth?: number): SkillInfo[];
+declare function findSkillsInDir(dir: string, sourceType: 'project' | 'personal' | 'locus', maxDepth?: number): SkillInfo[];
 /**
  * Find all agent definition files in a directory.
  */
-export declare function findAgentsInDir(dir: string, maxDepth?: number): AgentInfo[];
+declare function findAgentsInDir(dir: string, maxDepth?: number): AgentInfo[];
 /**
  * Resolve a skill name to its file path, handling namespacing and shadowing.
  * Priority: project > personal > locus
@@ -83,13 +97,33 @@ export declare function findAgentsInDir(dir: string, maxDepth?: number): AgentIn
  * - "project:skill-name" - forces project skills only
  * - "locus:skill-name" - forces locus skills only
  */
-export declare function resolveSkillPath(skillName: string, locusSkillsDir: string, personalSkillsDir: string | null, projectSkillsDir: string | null): ResolvedSkill | null;
+declare function resolveSkillPath(skillName: string, locusSkillsDir: string, personalSkillsDir: string | null, projectSkillsDir: string | null): ResolvedSkill | null;
 /**
  * Get the using-locus bootstrap skill content.
  */
-export declare function getBootstrapContent(locusSkillsDir: string, compact?: boolean): string | null;
+declare function getBootstrapContent(locusSkillsDir: string, compact?: boolean): string | null;
 /**
  * Normalize a path: trim whitespace, expand ~, resolve to absolute.
  */
-export declare function normalizePath(p: string | undefined, homeDir: string): string | null;
-//# sourceMappingURL=skills-core.d.ts.map
+declare function normalizePath(p: string | undefined, homeDir: string): string | null;
+
+/**
+ * Locus - OpenCode Plugin
+ *
+ * AI-powered project planning with skills framework.
+ * Provides custom tools for loading and discovering skills,
+ * with automatic bootstrap on session start.
+ */
+
+/**
+ * Locus Plugin for OpenCode
+ *
+ * Provides:
+ * - use_skill: Load and read a specific skill
+ * - find_skills: List all available skills
+ * - find_agents: List all available agents
+ * - Bootstrap injection on session start
+ */
+declare const LocusPlugin: Plugin;
+
+export { type AgentInfo, LocusPlugin, type ResolvedSkill, type SkillInfo, type SkillMetadata, LocusPlugin as default, extractFrontmatter, findAgentsInDir, findSkillsInDir, getBootstrapContent, getLocusAgentsDir, getLocusSkillsDir, getPackageRoot, normalizePath, resolveSkillPath, stripFrontmatter };

package/dist/index.d.ts

@@ -1,3 +1,112 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+/**
+ * Skills Core Library
+ * Shared utilities for skill discovery, loading, and management
+ */
+/**
+ * Get the package root directory (parent of dist/).
+ */
+declare function getPackageRoot(): string;
+/**
+ * Get the locus skills directory.
+ */
+declare function getLocusSkillsDir(): string;
+/**
+ * Get the locus agents directory.
+ */
+declare function getLocusAgentsDir(): string;
+interface SkillMetadata {
+    name: string;
+    description: string;
+    license?: string;
+    version?: string;
+    author?: string;
+    category?: string;
+    tier?: string;
+    council?: string;
+    tools?: string;
+    metadata?: {
+        version?: string;
+        tier?: string;
+        category?: string;
+        council?: string;
+        [key: string]: string | undefined;
+    };
+    [key: string]: string | Record<string, string | undefined> | undefined;
+}
+interface SkillInfo {
+    path: string;
+    skillFile: string;
+    name: string;
+    description: string;
+    sourceType: 'project' | 'personal' | 'locus';
+    tier?: string;
+    category?: string;
+    council?: string;
+    version?: string;
+}
+interface AgentInfo {
+    path: string;
+    name: string;
+    description: string;
+    model?: string;
+    category: string;
+}
+interface ResolvedSkill {
+    skillFile: string;
+    sourceType: 'project' | 'personal' | 'locus';
+    skillPath: string;
+}
+/**
+ * Extract YAML frontmatter from a skill or agent file.
+ *
+ * Supports:
+ * - Simple key: value pairs
+ * - Multiline values with |
+ * - Nested objects (one level deep, e.g., metadata:)
+ *
+ * Format:
+ * ---
+ * name: skill-name
+ * description: Use when [condition] - [what it does]
+ * metadata:
+ *   version: "1.0.0"
+ *   tier: developer
+ * ---
+ */
+declare function extractFrontmatter(filePath: string): SkillMetadata;
+/**
+ * Strip YAML frontmatter from content, returning just the body.
+ */
+declare function stripFrontmatter(content: string): string;
+/**
+ * Find all SKILL.md files in a directory recursively.
+ */
+declare function findSkillsInDir(dir: string, sourceType: 'project' | 'personal' | 'locus', maxDepth?: number): SkillInfo[];
+/**
+ * Find all agent definition files in a directory.
+ */
+declare function findAgentsInDir(dir: string, maxDepth?: number): AgentInfo[];
+/**
+ * Resolve a skill name to its file path, handling namespacing and shadowing.
+ * Priority: project > personal > locus
+ *
+ * Skill names can be:
+ * - "skill-name" - searches all locations
+ * - "project:skill-name" - forces project skills only
+ * - "locus:skill-name" - forces locus skills only
+ */
+declare function resolveSkillPath(skillName: string, locusSkillsDir: string, personalSkillsDir: string | null, projectSkillsDir: string | null): ResolvedSkill | null;
+/**
+ * Get the using-locus bootstrap skill content.
+ */
+declare function getBootstrapContent(locusSkillsDir: string, compact?: boolean): string | null;
+/**
+ * Normalize a path: trim whitespace, expand ~, resolve to absolute.
+ */
+declare function normalizePath(p: string | undefined, homeDir: string): string | null;
+
 /**
  * Locus - OpenCode Plugin
  *
@@ -5,7 +114,7 @@
  * Provides custom tools for loading and discovering skills,
  * with automatic bootstrap on session start.
  */
-import type { Plugin } from "@opencode-ai/plugin";
+
 /**
  * Locus Plugin for OpenCode
  *
@@ -15,7 +124,6 @@ import type { Plugin } from "@opencode-ai/plugin";
  * - find_agents: List all available agents
  * - Bootstrap injection on session start
  */
-export declare const LocusPlugin: Plugin;
-export default LocusPlugin;
-export * from "./lib/skills-core.js";
-//# sourceMappingURL=index.d.ts.map
+declare const LocusPlugin: Plugin;
+
+export { type AgentInfo, LocusPlugin, type ResolvedSkill, type SkillInfo, type SkillMetadata, LocusPlugin as default, extractFrontmatter, findAgentsInDir, findSkillsInDir, getBootstrapContent, getLocusAgentsDir, getLocusSkillsDir, getPackageRoot, normalizePath, resolveSkillPath, stripFrontmatter };