@enactprotocol/cli 2.1.14 → 2.1.17

package/src/commands/init/index.ts

@@ -10,6 +10,12 @@ import { getSecret } from "@enactprotocol/secrets";
 import type { Command } from "commander";
 import type { CommandContext, GlobalOptions } from "../../types";
 import { error, formatError, info, success, warning } from "../../utils";
+import {
+  agentAgentsTemplate,
+  claudeTemplate,
+  toolAgentsTemplate,
+  toolSkillTemplate,
+} from "./templates";
 
 /** Namespace for stored auth tokens */
 const AUTH_NAMESPACE = "enact:auth";
@@ -23,388 +29,13 @@ const SUPABASE_ANON_KEY =
   "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InNpaWt3a2Znc21vdWlvb2RnaGhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjQ2MTkzMzksImV4cCI6MjA4MDE5NTMzOX0.kxnx6-IPFhmGx6rzNx36vbyhFMFZKP_jFqaDbKnJ_E0";
 
 /**
- * Embedded templates (for single-binary compatibility)
+ * Template mapping for loadTemplate function
  */
 const TEMPLATES: Record<string, string> = {
-  "tool-skill.md": `---
-name: {{TOOL_NAME}}
-description: A simple tool that echoes a greeting
-version: 0.1.0
-enact: "2.0"
-
-from: alpine:latest
-
-inputSchema:
-  type: object
-  properties:
-    name:
-      type: string
-      description: Name to greet
-      default: World
-  required: []
-
-command: |
-  echo "Hello, \${name}!"
----
-
-# {{TOOL_NAME}}
-
-A simple greeting tool created with \`enact init\`.
-
-## Usage
-
-\`\`\`bash
-enact run ./ --args '{"name": "Alice"}'
-\`\`\`
-
-## Customization
-
-Edit this file to create your own tool:
-
-1. Update the \`name\` and \`description\` in the frontmatter
-2. Modify the \`inputSchema\` to define your tool's inputs
-3. Change the \`command\` to run your desired shell commands
-4. Update this documentation section
-
-## Learn More
-
-- [Enact Documentation](https://enact.dev/docs)
-- [Tool Manifest Reference](https://enact.dev/docs/manifest)
-`,
-
-  "tool-agents.md": `# Enact Tool Development Guide
-
-Enact tools are containerized, cryptographically-signed executables. Each tool is defined by a \`SKILL.md\` file (YAML frontmatter + Markdown docs).
-
-## Quick Reference
-
-| Task | Command |
-|------|---------|
-| Run with JSON | \`enact run ./ --args '{"key": "value"}'\` |
-| Run from file | \`enact run ./ --input-file inputs.json\` |
-| Dry run | \`enact run ./ --args '{}' --dry-run\` |
-| Sign & publish | \`enact sign ./ && enact publish ./\` |
-
-## SKILL.md Structure
-
-\`\`\`yaml
----
-name: {{TOOL_NAME}}
-description: What the tool does
-version: 1.0.0
-enact: "2.0.0"
-
-from: python:3.12-slim            # Docker image (pin versions, not :latest)
-build: pip install requests       # Build steps (cached by Dagger)
-command: python /work/main.py \${input}
-timeout: 30s
-
-inputSchema:
-  type: object
-  properties:
-    input:
-      type: string
-      description: "Input to process"
-  required: [input]
-
-outputSchema:
-  type: object
-  properties:
-    result:
-      type: string
-
-env:
-  API_KEY:
-    description: "External API key"
-    secret: true                  # Set via: enact env set API_KEY --secret
----
-# Tool Name
-Documentation here.
-\`\`\`
-
-## Field Reference
-
-| Field | Description |
-|-------|-------------|
-| \`name\` | Hierarchical ID: \`org/category/tool\` |
-| \`description\` | What the tool does |
-| \`version\` | Semver version |
-| \`from\` | Docker image |
-| \`build\` | Build commands (string or array, cached) |
-| \`command\` | Shell command with \`\${param}\` substitution |
-| \`timeout\` | Max execution time (e.g., "30s", "5m") |
-| \`inputSchema\` | JSON Schema for inputs |
-| \`outputSchema\` | JSON Schema for outputs |
-| \`env\` | Environment variables and secrets |
-
-## Parameter Substitution
-
-Enact auto-quotes parameters. **Never manually quote:**
-
-\`\`\`yaml
-# WRONG - causes double-quoting
-command: python /work/main.py "\${input}"
-
-# RIGHT - Enact handles quoting
-command: python /work/main.py \${input}
-\`\`\`
-
-**Optional params:** Missing optional params become empty strings. Always provide defaults:
-\`\`\`yaml
-inputSchema:
-  properties:
-    greeting: 
-      type: string
-      default: "Hello"  # Recommended for optional params
-\`\`\`
-
-Or handle empty in shell:
-\`\`\`yaml
-command: "echo \${greeting:-Hello} \${name}"
-\`\`\`
-
-Modifiers:
-- \`\${param}\` — auto-quoted (handles spaces, JSON, special chars)
-- \`\${param:raw}\` — raw, no quoting (use carefully)
-
-## Output
-
-Output valid JSON to stdout when \`outputSchema\` is defined:
-
-\`\`\`python
-import json, sys
-
-try:
-    result = do_work()
-    print(json.dumps({"status": "success", "result": result}))
-except Exception as e:
-    print(json.dumps({"status": "error", "message": str(e)}))
-    sys.exit(1)  # non-zero = error
-\`\`\`
-
-## Build Steps by Language
-
-**Python:**
-\`\`\`yaml
-from: python:3.12-slim
-build: pip install requests pandas
-\`\`\`
-
-**Node.js:**
-\`\`\`yaml
-from: node:20-alpine
-build:
-  - npm install
-  - npm run build
-\`\`\`
-
-**Rust:**
-\`\`\`yaml
-from: rust:1.83-slim
-build: rustc /work/main.rs -o /work/tool
-command: /work/tool \${input}
-\`\`\`
-
-**Go:**
-\`\`\`yaml
-from: golang:1.22-alpine
-build: cd /work && go build -o tool main.go
-command: /work/tool \${input}
-\`\`\`
-
-**System packages:**
-\`\`\`yaml
-build: apt-get update && apt-get install -y libfoo-dev
-\`\`\`
-
-Build steps are cached — first run slow, subsequent runs instant.
-
-## File Access
-
-Tools run in a container with \`/work\` as the working directory. All source files are copied there.
-
-## Secrets
-
-Declare in \`SKILL.md\`:
-\`\`\`yaml
-env:
-  API_KEY:
-    description: "API key for service"
-    secret: true
-\`\`\`
-
-Set before running:
-\`\`\`bash
-enact env set API_KEY --secret --namespace {{TOOL_NAME}}
-\`\`\`
-
-Access in code:
-\`\`\`python
-import os
-api_key = os.environ.get('API_KEY')
-\`\`\`
-
-## LLM Instruction Tools
-
-Tools without a \`command\` field are interpreted by LLMs:
-
-\`\`\`yaml
----
-name: myorg/ai/reviewer
-description: AI-powered code review
-inputSchema:
-  type: object
-  properties:
-    code: { type: string }
-  required: [code]
-outputSchema:
-  type: object
-  properties:
-    issues: { type: array }
-    score: { type: number }
----
-# Code Reviewer
-
-You are a senior engineer. Review the code for bugs, style, and security.
-Return JSON: {"issues": [...], "score": 75}
-\`\`\`
-
-## Publishing Checklist
-
-- [ ] \`name\` follows \`namespace/category/tool\` pattern
-- [ ] \`version\` set (semver)
-- [ ] \`description\` is clear and searchable
-- [ ] \`inputSchema\` / \`outputSchema\` defined
-- [ ] \`from\` uses pinned image version
-- [ ] \`timeout\` set appropriately
-- [ ] Tool tested locally with \`enact run ./\`
-
-## Troubleshooting
-
-\`\`\`bash
-enact run ./ --args '{"x": "y"}' --verbose   # Verbose output
-enact run ./ --args '{}' --dry-run             # Preview command
-enact list                                      # List installed tools
-\`\`\`
-`,
-
-  "agent-agents.md": `# AGENTS.md
-
-This project uses Enact tools — containerized, cryptographically-signed executables.
-
-## Running Tools
-\`\`\`bash
-enact run <tool-name> --args '{"key": "value"}'   # Run installed tool
-enact run ./path/to/tool --args '{}'              # Run local tool
-\`\`\`
-
-## Finding & Installing Tools
-\`\`\`bash
-enact search "pdf extraction"                     # Search registry
-enact get author/category/tool                    # View tool info
-enact learn author/category/tool                  # View tool documentation
-enact install author/category/tool                # Add to project (.enact/tools.json)
-enact install author/category/tool --global       # Add globally
-enact list                                        # List project tools
-\`\`\`
-
-## Tool Output
-Tools output JSON to stdout. Parse with jq or your language's JSON parser:
-\`\`\`bash
-enact run tool --args '{}' | jq '.result'
-\`\`\`
-
-## Creating Local Tools
-Create \`tools/<name>/SKILL.md\` with:
-\`\`\`yaml
----
-name: my-tool
-description: What it does
-command: echo "Hello \${name}"
-inputSchema:
-  type: object
-  properties:
-    name: { type: string }
----
-# My Tool
-Documentation here.
-\`\`\`
-Run with: \`enact run ./tools/<name> --args '{"name": "World"}'\`
-
-## Environment & Secrets
-\`\`\`bash
-enact env set API_KEY --secret --namespace author/tool  # Set secret
-enact env list                                          # List env vars
-\`\`\`
-`,
-
-  "claude.md": `# CLAUDE.md
-
-This project uses Enact tools — containerized, signed executables you can run via CLI.
-
-## Quick Reference
-\`\`\`bash
-enact run <tool> --args '{"key": "value"}'   # Run a tool
-enact search "keyword"                        # Find tools
-enact learn author/tool                       # View tool documentation
-enact install author/tool                     # Install tool
-enact list                                    # List installed tools
-\`\`\`
-
-## Running Tools
-Tools take JSON input and return JSON output:
-\`\`\`bash
-# Run and capture output
-result=$(enact run author/utils/formatter --args '{"code": "const x=1"}')
-
-# Parse with jq
-enact run tool --args '{}' | jq '.data'
-\`\`\`
-
-## Creating Tools
-Create \`SKILL.md\` in a directory:
-\`\`\`yaml
----
-name: namespace/category/tool
-description: Clear description for search
-version: 1.0.0
-from: python:3.12-slim            # Docker image
-build: pip install requests       # Install dependencies (cached)
-command: python /work/main.py \${input}
-inputSchema:
-  type: object
-  properties:
-    input: { type: string, description: "The input to process" }
-  required: [input]
----
-# Tool Name
-Usage documentation here.
-\`\`\`
-
-Key points:
-- \`\${param}\` is auto-quoted — never add manual quotes
-- \`from:\` pin image versions (not \`:latest\`)
-- \`build:\` steps are cached by Dagger
-- Output JSON to stdout, errors to stderr
-- Non-zero exit = failure
-
-## Tool Development Workflow
-\`\`\`bash
-enact run ./ --args '{"input": "test"}'       # Test locally
-enact run ./ --args '{}' --dry-run            # Preview command
-enact sign ./ && enact publish ./             # Publish
-\`\`\`
-
-## Secrets
-Declare in SKILL.md, set via CLI:
-\`\`\`yaml
-env:
-  API_KEY:    # Declared but not set
-\`\`\`
-\`\`\`bash
-enact env set API_KEY --secret --namespace author/tool
-\`\`\`
-`,
+  "tool-skill.md": toolSkillTemplate,
+  "tool-agents.md": toolAgentsTemplate,
+  "agent-agents.md": agentAgentsTemplate,
+  "claude.md": claudeTemplate,
 };
 
 interface InitOptions extends GlobalOptions {

package/src/commands/init/templates/{agent-agents.md → agent-agents.ts}

@@ -1,35 +1,39 @@
-# AGENTS.md
+/**
+ * AGENTS.md template for projects that use Enact tools
+ */
+export const agentAgentsTemplate = `# AGENTS.md
 
 This project uses Enact tools — containerized, cryptographically-signed executables.
 
 ## Running Tools
-```bash
+\`\`\`bash
 enact run <tool-name> --args '{"key": "value"}'   # Run installed tool
 enact run ./path/to/tool --args '{}'              # Run local tool
-```
+\`\`\`
 
 ## Finding & Installing Tools
-```bash
+\`\`\`bash
 enact search "pdf extraction"                     # Search registry
-enact get author/category/tool                    # View tool info
+enact info author/category/tool                   # View tool info
+enact learn author/category/tool                  # View tool documentation
 enact install author/category/tool                # Add to project (.enact/tools.json)
 enact install author/category/tool --global       # Add globally
 enact list                                        # List project tools
-```
+\`\`\`
 
 ## Tool Output
 Tools output JSON to stdout. Parse with jq or your language's JSON parser:
-```bash
+\`\`\`bash
 enact run tool --args '{}' | jq '.result'
-```
+\`\`\`
 
 ## Creating Local Tools
-Create `tools/<name>/enact.md` with:
-```yaml
+Create \`tools/<name>/SKILL.md\` with:
+\`\`\`yaml
 ---
 name: my-tool
 description: What it does
-command: echo "Hello ${name}"
+command: echo "Hello \${name}"
 inputSchema:
   type: object
   properties:
@@ -37,11 +41,12 @@ inputSchema:
 ---
 # My Tool
 Documentation here.
-```
-Run with: `enact run ./tools/<name> --args '{"name": "World"}'`
+\`\`\`
+Run with: \`enact run ./tools/<name> --args '{"name": "World"}'\`
 
 ## Environment & Secrets
-```bash
+\`\`\`bash
 enact env set API_KEY --secret --namespace author/tool  # Set secret
 enact env list                                          # List env vars
-```
+\`\`\`
+`;

package/src/commands/init/templates/{claude.md → claude.ts}

@@ -1,35 +1,39 @@
-# CLAUDE.md
+/**
+ * CLAUDE.md template for Claude integration
+ */
+export const claudeTemplate = `# CLAUDE.md
 
 This project uses Enact tools — containerized, signed executables you can run via CLI.
 
 ## Quick Reference
-```bash
+\`\`\`bash
 enact run <tool> --args '{"key": "value"}'   # Run a tool
 enact search "keyword"                        # Find tools
+enact learn author/tool                       # View tool documentation
 enact install author/tool                     # Install tool
 enact list                                    # List installed tools
-```
+\`\`\`
 
 ## Running Tools
 Tools take JSON input and return JSON output:
-```bash
+\`\`\`bash
 # Run and capture output
 result=$(enact run author/utils/formatter --args '{"code": "const x=1"}')
 
 # Parse with jq
 enact run tool --args '{}' | jq '.data'
-```
+\`\`\`
 
 ## Creating Tools
-Create `enact.md` in a directory:
-```yaml
+Create \`SKILL.md\` in a directory:
+\`\`\`yaml
 ---
 name: namespace/category/tool
 description: Clear description for search
 version: 1.0.0
 from: python:3.12-slim            # Docker image
 build: pip install requests       # Install dependencies (cached)
-command: python /work/main.py ${input}
+command: python /work/main.py \${input}
 inputSchema:
   type: object
   properties:
@@ -38,28 +42,29 @@ inputSchema:
 ---
 # Tool Name
 Usage documentation here.
-```
+\`\`\`
 
 Key points:
-- `${param}` is auto-quoted — never add manual quotes
-- `from:` pin image versions (not `:latest`)
-- `build:` steps are cached by Dagger
+- \`\${param}\` is auto-quoted — never add manual quotes
+- \`from:\` pin image versions (not \`:latest\`)
+- \`build:\` steps are cached by Dagger
 - Output JSON to stdout, errors to stderr
 - Non-zero exit = failure
 
 ## Tool Development Workflow
-```bash
+\`\`\`bash
 enact run ./ --args '{"input": "test"}'       # Test locally
 enact run ./ --args '{}' --dry-run            # Preview command
 enact sign ./ && enact publish ./             # Publish
-```
+\`\`\`
 
 ## Secrets
-Declare in enact.md, set via CLI:
-```yaml
+Declare in SKILL.md, set via CLI:
+\`\`\`yaml
 env:
   API_KEY:    # Declared but not set
-```
-```bash
+\`\`\`
+\`\`\`bash
 enact env set API_KEY --secret --namespace author/tool
-```
+\`\`\`
+`;

package/src/commands/init/templates/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Template exports for enact init command
+ */
+export { toolSkillTemplate } from "./tool-skill";
+export { toolAgentsTemplate } from "./tool-agents";
+export { agentAgentsTemplate } from "./agent-agents";
+export { claudeTemplate } from "./claude";