@esotech/contextuate 2.1.0 → 2.1.1

package/dist/commands/install.js

@@ -60,10 +60,10 @@ async function discoverTemplates() {
             .filter(f => f.endsWith('.md'))
             .map(f => f.replace('.md', ''));
     }
-    // Discover skills
-    const skillsDir = path_1.default.join(templateSource, 'skills');
-    if (fs_extra_1.default.existsSync(skillsDir)) {
-        const files = await fs_extra_1.default.readdir(skillsDir);
+    // Discover skills (stored in commands/ directory)
+    const commandsDir = path_1.default.join(templateSource, 'commands');
+    if (fs_extra_1.default.existsSync(commandsDir)) {
+        const files = await fs_extra_1.default.readdir(commandsDir);
         result.skills = files
             .filter(f => f.endsWith('.md'))
             .map(f => f.replace('.md', ''));
@@ -188,7 +188,7 @@ async function installTools(names, force) {
     return installed;
 }
 // Install skills (slash commands)
-// Skills are installed to docs/ai/skills/ and symlinked to docs/ai/commands/ for Claude Code
+// Skills are installed directly to docs/ai/commands/ for Claude Code
 async function installSkills(names, force) {
     const templateSource = getTemplateSource();
     const templates = await discoverTemplates();
@@ -197,26 +197,10 @@ async function installSkills(names, force) {
         const normalized = name.toLowerCase().trim().replace(/^\//, ''); // Remove leading slash if present
         const matched = templates.skills.find(s => s.toLowerCase() === normalized);
         if (matched) {
-            const src = path_1.default.join(templateSource, 'skills', `${matched}.md`);
-            const skillDest = path_1.default.join('docs/ai/skills', `${matched}.md`);
-            const commandDest = path_1.default.join('docs/ai/commands', `${matched}.md`);
-            // Install skill file to skills/
-            if (await copyFile(src, skillDest, force)) {
+            const src = path_1.default.join(templateSource, 'commands', `${matched}.md`);
+            const dest = path_1.default.join('docs/ai/commands', `${matched}.md`);
+            if (await copyFile(src, dest, force)) {
                 installed++;
-                // Create symlink in commands/ for Claude Code to pick up
-                await fs_extra_1.default.ensureDir(path_1.default.dirname(commandDest));
-                const symlinkTarget = path_1.default.relative(path_1.default.dirname(commandDest), skillDest);
-                if (fs_extra_1.default.existsSync(commandDest)) {
-                    if (force) {
-                        await fs_extra_1.default.remove(commandDest);
-                    }
-                    else {
-                        console.log(chalk_1.default.yellow(`[SKIP] Symlink already exists: ${commandDest}`));
-                        continue;
-                    }
-                }
-                await fs_extra_1.default.symlink(symlinkTarget, commandDest);
-                console.log(chalk_1.default.green(`[OK] Symlinked: ${commandDest} -> ${symlinkTarget}`));
             }
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esotech/contextuate",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "**Standardized AI Context for Software Projects**",
   "main": "dist/index.js",
   "bin": {
@@ -11,7 +11,7 @@
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc && mkdir -p dist/templates && cp -r src/templates/* dist/templates/ && mkdir -p dist/monitor/hooks && cp src/monitor/hooks/emit-event.js dist/monitor/hooks/ && chmod +x dist/index.js dist/monitor/hooks/emit-event.js dist/monitor/daemon/cli.js dist/monitor/server/cli.js",
+    "build": "tsc && rm -rf dist/templates && mkdir -p dist/templates && cp -r src/templates/* dist/templates/ && mkdir -p dist/monitor/hooks && cp src/monitor/hooks/emit-event.js dist/monitor/hooks/ && chmod +x dist/index.js dist/monitor/hooks/emit-event.js dist/monitor/daemon/cli.js dist/monitor/server/cli.js",
     "build:monitor-ui": "cd src/monitor/ui && npm install && npm run build",
     "build:all": "npm run build && npm run build:monitor-ui",
     "prepublishOnly": "npm run build:all"

package/dist/templates/skills/pythia.md

@@ -1,37 +0,0 @@
-# /pythia - Strategic Planning Oracle
-
-Alias for `/consult`. Activates the PYTHIA agent for strategic planning and research.
-
-## Agent Invocation
-
-**IMPORTANT:** Before proceeding, read and adopt the PYTHIA agent persona:
-
-**Agent Definition:** [agents/pythia.md](../agents/pythia.md)
-
-Read the agent file above, then follow its guidelines for research, synthesis, and specification creation.
-
-## Usage
-
-```
-/pythia [topic or question]
-```
-
-See [/consult](./consult.md) for full documentation and behavior details.
-
-## Quick Reference
-
-| Command | Purpose |
-|---------|---------|
-| `/pythia [topic]` | Research and plan before implementation |
-| `/consult [topic]` | Same as `/pythia` |
-| `/orchestrate [task]` | Execute implementation with specialist agents |
-
-## Example Flow
-
-```
-/pythia How should we implement real-time notifications?
-    |
-[PYTHIA produces specification]
-    |
-/orchestrate Implement the notification system per spec
-```

package/dist/templates/templates/standards/go.standards.md

@@ -1,167 +0,0 @@
-# Go Coding Standards
-
-> **Language:** Go
-> **Generated:** {DATE}
-
----
-
-## Formatting
-
-### Tooling
-- **Required:** `gofmt` (or `goimports`) must be applied to all files.
-
-### Indentation
-- **Style:** Tabs (Standard Go behavior)
-
-### Line Length
-- **Guideline:** No strict limit, but prefer readability (80-120 chars).
-
----
-
-## Naming Conventions
-
-### General Rule
-- Use `MixedCaps` or `mixedCaps` (CamelCase).
-- Keep names short and concise.
-
-### Packages
-- **Style:** lowercase, single word
-- **Avoid:** snake_case, camelCase in package names
-- **Example:** `package user`, not `package user_service`
-
-### Interfaces
-- **Style:** Method name + "er" (if single method)
-- **Example:** `Reader`, `Writer`, `Formatter`
-
-### Structs/Interfaces
-- **Exported:** PascalCase (`User`)
-- **Unexported:** camelCase (`userHelper`)
-
-### Functions/Methods
-- **Exported:** PascalCase (`GetUser`)
-- **Unexported:** camelCase (`parseData`)
-
-### Constants
-- **Style:** PascalCase (for exported) or camelCase
-- **Avoid:** UPPER_SNAKE_CASE (unlike other languages)
-- **Example:** `MaxRetries`, not `MAX_RETRIES`
-
----
-
-## Structure
-
-### File Organization
-```go
-package main
-
-// 1. Imports (grouped: stdlib, third-party, local)
-import (
-    "fmt"
-    "os"
-
-    "github.com/pkg/errors"
-
-    "myproject/internal/user"
-)
-
-// 2. Constants
-const DefaultTimeout = 30
-
-// 3. Types (Structs/Interfaces)
-type Service interface {
-    Do() error
-}
-
-// 4. Factory Functions
-func NewService() Service {
-    return &serviceImpl{}
-}
-
-// 5. Methods
-func (s *serviceImpl) Do() error {
-    return nil
-}
-```
-
----
-
-## Error Handling
-
-### Pattern
-- **Style:** Check errors immediately. Avoid nesting.
-
-```go
-// GOOD
-f, err := os.Open("file.txt")
-if err != nil {
-    return err
-}
-
-// BAD
-if f, err := os.Open("file.txt"); err == nil {
-    // ...
-}
-```
-
-### Wrapping
-- **Guideline:** Wrap errors with context when passing up the stack.
-- **Example:** `fmt.Errorf("failed to open config: %w", err)`
-
----
-
-## Documentation
-
-### Comments
-- **Exported identifiers:** MUST have a doc comment starting with the name.
-- **Format:** Complete sentences.
-
-```go
-// User represents a system user.
-type User struct { ... }
-
-// Fetch retrieves the user by ID.
-func (u *User) Fetch(id int) error { ... }
-```
-
----
-
-## Common Patterns
-
-### Options Pattern
-```go
-// Preferred for complex constructors
-type Option func(*Server)
-
-func WithPort(port int) Option {
-    return func(s *Server) { s.port = port }
-}
-
-func NewServer(opts ...Option) *Server { ... }
-```
-
-### Context
-- **Guideline:** Pass `context.Context` as the first argument to functions performing I/O.
-
-```go
-func (s *Service) GetData(ctx context.Context, id string) error { ... }
-```
-
----
-
-## Anti-Patterns
-
-```go
-// BAD: Panic in libraries
-func Parse() {
-    if err != nil {
-        panic(err) // Return error instead
-    }
-}
-
-// BAD: Global state
-var db *sql.DB // Use dependency injection
-```
-
----
-
-*This file should be customized for your project. Replace placeholders with actual values.*

package/dist/templates/templates/standards/java.standards.md

@@ -1,167 +0,0 @@
-# Java Coding Standards
-
-> **Language:** Java
-> **Generated:** {DATE}
-
----
-
-## Formatting
-
-### Indentation
-- **Style:** {Spaces}
-- **Size:** {4} {spaces}
-
-### Braces
-- **Style:** K&R (same line) for classes and methods.
-
-### Line Length
-- **Max Length:** {100|120} chars
-
----
-
-## Naming Conventions
-
-### Classes/Interfaces
-- **Style:** PascalCase
-- **Example:** `UserManager`, `PaymentProcessor`
-
-### Methods
-- **Style:** camelCase
-- **Example:** `calculateTotal()`, `findUserById()`
-
-### Variables
-- **Style:** camelCase
-- **Example:** `firstName`, `orderCount`
-
-### Constants (static final)
-- **Style:** UPPER_SNAKE_CASE
-- **Example:** `DEFAULT_TIMEOUT`, `MAX_USERS`
-
-### Generics
-- **Style:** Single capital letter
-- **Example:** `E` (element), `T` (type), `K` (key), `V` (value)
-
----
-
-## Structure
-
-### File Organization
-```java
-// 1. Package declaration
-package com.company.project.service;
-
-// 2. Imports (sorted alphabetically, no wildcards)
-import java.util.List;
-import org.springframework.stereotype.Service;
-
-// 3. Class definition
-@Service
-public class UserService {
-
-    // 4. Constants
-    private static final int MAX_AGE = 100;
-
-    // 5. Fields
-    private final UserRepository userRepository;
-
-    // 6. Constructor
-    public UserService(UserRepository userRepository) {
-        this.userRepository = userRepository;
-    }
-
-    // 7. Public methods
-    public User getUser(Long id) {
-        // ...
-    }
-
-    // 8. Private methods
-    private void validate(User user) {
-        // ...
-    }
-}
-```
-
----
-
-## Documentation (Javadoc)
-
-### Required Elements
-- **Classes:** Purpose of the class.
-- **Public Methods:** Description, `@param`, `@return`, `@throws`.
-
-```java
-/**
- * Processes payment transactions.
- */
-public class PaymentService {
-
-    /**
-     * Authorizes a transaction.
-     *
-     * @param amount The amount to authorize
-     * @return true if successful
-     * @throws PaymentException if connection fails
-     */
-    public boolean authorize(BigDecimal amount) throws PaymentException { ... }
-}
-```
-
----
-
-## Error Handling
-
-### Exceptions
-- **Guideline:** Use unchecked exceptions (`RuntimeException`) for recoverable errors.
-- **Guideline:** Avoid swallowing exceptions.
-
-```java
-// GOOD
-try {
-    file.read();
-} catch (IOException e) {
-    throw new UncheckedIOException("Failed to read config", e);
-}
-
-// BAD
-catch (Exception e) {
-    e.printStackTrace(); // Use a logger
-}
-```
-
----
-
-## Common Patterns
-
-### Optional
-- **Guideline:** Use `Optional<T>` for return types that may be null.
-- **Avoid:** Using `Optional` in parameters or fields.
-
-```java
-public Optional<User> findByEmail(String email) { ... }
-```
-
-### Streams API
-- **Guideline:** Prefer Streams for collections processing.
-
-```java
-List<String> names = users.stream()
-    .filter(User::isActive)
-    .map(User::getName)
-    .collect(Collectors.toList());
-```
-
----
-
-## Anti-Patterns
-
-```java
-// BAD: Public fields
-public String name; // Use private + getter
-
-// BAD: Magic numbers
-if (status == 4) // Use constant STATUS_ACTIVE
-```
-
----
-
-*This file should be customized for your project. Replace placeholders with actual values.*