@pennixrv/trellis 0.6.17

package/dist/templates/dsh/DSH.md

@@ -0,0 +1,56 @@
+# Trellis on DeepSeek Harness (dsh)
+
+dsh is a **class-2 pull-based** Trellis host: no session-start hook auto-injects
+workflow context, so the agent loads the Trellis skills on demand through its
+skill-loader tool.
+
+| Capability | Status |
+| --- | --- |
+| Skills (`.agents/skills/trellis-*/SKILL.md`) | Works — dsh discovers this shared root natively |
+| Entry skills (`.dsh/skills/trellis-*/SKILL.md`) | Works — dsh's own project skill root (highest rank) |
+| Context hooks | None — pull-based: skills read `.trellis/` files directly |
+| Sub-agents | None shipped — implement/check/research run inline via the workflow skills |
+
+## Quick start
+
+```bash
+trellis init --dsh -u your-name
+dsh web        # or: dsh --profile headless "start a Trellis task for ..."
+```
+
+In dsh:
+
+1. Open a session in the project root and describe the work in natural
+   language. For a new task the agent should load the `trellis-start` skill,
+   which reads the current task state from `.trellis/` and routes to
+   `trellis-brainstorm` (unclear requirements), `trellis-before-dev` (about to
+   write code), `trellis-check` (done coding), or `trellis-update-spec`
+   (learned something worth capturing).
+2. Entry skills are `trellis-start` / `trellis-continue` / `trellis-finish-work`
+   in `.dsh/skills/`. You can also ask for them by name at any time.
+3. Type `/trellis:finish-work` is a slash-command convention from other hosts —
+   dsh has no slash palette, so say "finish the trellis task" instead, and the
+   agent loads `trellis-finish-work`.
+
+## File map
+
+- `.agents/skills/` — auto-triggered workflow skills (`trellis-before-dev`,
+  `trellis-brainstorm`, `trellis-check`, `trellis-break-loop`,
+  `trellis-update-spec`) plus the bundled `trellis-meta` /
+  `trellis-spec-bootstrap` / `trellis-session-insight` skills. Byte-identical
+  to Codex / Gemini CLI / Pi / Kimi writes into the same shared root.
+- `.dsh/skills/` — dsh-private entry skills (`trellis-start` /
+  `trellis-continue` / `trellis-finish-work`).
+- `.trellis/` — specs, tasks, workspace memory, and the shared scripts the
+  skills invoke (`get_context.py`, `task.py`, ...).
+
+## Notes
+
+- Skill scripts pass `--platform dsh` to `get_context.py`; the value is used
+  as a platform-scoped context key.
+- The shipped `minimal` agent preset composes only `bash` +
+  `str_replace_editor`; the default presets include `web_search` and the
+  filesystem/terminal tools the skills assume.
+- dsh has no project-level sub-agent definition surface, so Trellis ships no
+  `trellis-implement` / `trellis-check` / `trellis-research` agent prompts
+  here — the workflow skills run those phases inline in the main session.

package/dist/templates/dsh/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DeepSeek Harness (dsh) template module.
+ *
+ * dsh is a class-2 pull-based, skills-only platform:
+ * - Workflow + bundled skills go to the shared `.agents/skills/` root via
+ *   the neutral resolver (byte-identical to Codex/Gemini/Pi/Kimi writes).
+ * - User-invocable entry points (`trellis-start` / `trellis-continue` /
+ *   `trellis-finish-work`, loaded by the dsh agent through its skill-loader
+ *   tool) live under `.dsh/skills/<name>/SKILL.md` — dsh's own highest-rank
+ *   project skill root.
+ * - Operator guide `.dsh/DSH.md`.
+ *
+ * dsh has no shipped session-start hook, so `trellis-start` is kept as a
+ * user-invocable skill. dsh ships no project-level sub-agent definition
+ * surface, so no trellis-implement / trellis-check / trellis-research agent
+ * prompts are written; implement/check/research run inline through the
+ * workflow skills.
+ */
+/** Operator guide copied to `.dsh/DSH.md`. */
+export declare function getDshGuide(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/dsh/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/dsh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,8CAA8C;AAC9C,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/templates/dsh/index.js

@@ -0,0 +1,25 @@
+/**
+ * DeepSeek Harness (dsh) template module.
+ *
+ * dsh is a class-2 pull-based, skills-only platform:
+ * - Workflow + bundled skills go to the shared `.agents/skills/` root via
+ *   the neutral resolver (byte-identical to Codex/Gemini/Pi/Kimi writes).
+ * - User-invocable entry points (`trellis-start` / `trellis-continue` /
+ *   `trellis-finish-work`, loaded by the dsh agent through its skill-loader
+ *   tool) live under `.dsh/skills/<name>/SKILL.md` — dsh's own highest-rank
+ *   project skill root.
+ * - Operator guide `.dsh/DSH.md`.
+ *
+ * dsh has no shipped session-start hook, so `trellis-start` is kept as a
+ * user-invocable skill. dsh ships no project-level sub-agent definition
+ * surface, so no trellis-implement / trellis-check / trellis-research agent
+ * prompts are written; implement/check/research run inline through the
+ * workflow skills.
+ */
+import { createTemplateReader } from "../template-utils.js";
+const { readTemplate } = createTemplateReader(import.meta.url);
+/** Operator guide copied to `.dsh/DSH.md`. */
+export function getDshGuide() {
+    return readTemplate("DSH.md");
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/dsh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/dsh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,EAAE,YAAY,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/D,8CAA8C;AAC9C,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/templates/extract.d.ts

@@ -0,0 +1,40 @@
+type TemplateCategory = "scripts" | "markdown" | "commands";
+/**
+ * Get the path to the trellis templates directory (.trellis/ scaffolding).
+ */
+export declare function getTrellisTemplatePath(): string;
+/** @deprecated Use getTrellisTemplatePath() instead. */
+export declare function getTrellisSourcePath(): string;
+/**
+ * Get the path to the claude templates directory (hooks, agents, settings).
+ */
+export declare function getClaudeTemplatePath(): string;
+/**
+ * Get the path to the opencode templates directory (agents, plugins, lib).
+ */
+export declare function getOpenCodeTemplatePath(): string;
+/**
+ * Get the path to the Pi Agent templates directory (agents, extension, settings).
+ */
+export declare function getPiTemplatePath(): string;
+/** @deprecated Use getPiTemplatePath() instead. */
+export declare function getPiSourcePath(): string;
+/**
+ * Read a file from the trellis template directory.
+ */
+export declare function readTrellisFile(relativePath: string): string;
+/**
+ * Read template content from a category directory.
+ */
+export declare function readTemplate(category: TemplateCategory, filename: string): string;
+export declare function readScript(relativePath: string): string;
+export declare function readMarkdown(relativePath: string): string;
+export declare function readCommand(filename: string): string;
+/**
+ * Copy a directory from trellis templates to target, making scripts executable.
+ */
+export declare function copyTrellisDir(srcRelativePath: string, destPath: string, options?: {
+    executable?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=extract.d.ts.map

package/dist/templates/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"AASA,KAAK,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAQ9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED,mDAAmD;AACnD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/templates/extract.js

@@ -0,0 +1,106 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ensureDir, writeFile } from "../utils/file-writer.js";
+import { replacePythonCommandLiterals } from "../configurators/shared.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the path to the trellis templates directory (.trellis/ scaffolding).
+ */
+export function getTrellisTemplatePath() {
+    const templatePath = path.join(__dirname, "trellis");
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error("Could not find trellis templates directory. Expected at templates/trellis/");
+}
+/** @deprecated Use getTrellisTemplatePath() instead. */
+export function getTrellisSourcePath() {
+    return getTrellisTemplatePath();
+}
+/**
+ * Get the path to the claude templates directory (hooks, agents, settings).
+ */
+export function getClaudeTemplatePath() {
+    const templatePath = path.join(__dirname, "claude");
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error("Could not find claude templates directory. Expected at templates/claude/");
+}
+/**
+ * Get the path to the opencode templates directory (agents, plugins, lib).
+ */
+export function getOpenCodeTemplatePath() {
+    const templatePath = path.join(__dirname, "opencode");
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error("Could not find opencode templates directory. Expected at templates/opencode/");
+}
+/**
+ * Get the path to the Pi Agent templates directory (agents, extension, settings).
+ */
+export function getPiTemplatePath() {
+    const templatePath = path.join(__dirname, "pi");
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error("Could not find pi templates directory. Expected at templates/pi/");
+}
+/** @deprecated Use getPiTemplatePath() instead. */
+export function getPiSourcePath() {
+    return getPiTemplatePath();
+}
+/**
+ * Read a file from the trellis template directory.
+ */
+export function readTrellisFile(relativePath) {
+    const trellisPath = getTrellisSourcePath();
+    const filePath = path.join(trellisPath, relativePath);
+    return fs.readFileSync(filePath, "utf-8");
+}
+/**
+ * Read template content from a category directory.
+ */
+export function readTemplate(category, filename) {
+    const templatePath = path.join(__dirname, category, filename);
+    return fs.readFileSync(templatePath, "utf-8");
+}
+export function readScript(relativePath) {
+    return readTrellisFile(`scripts/${relativePath}`);
+}
+export function readMarkdown(relativePath) {
+    return readTrellisFile(relativePath);
+}
+export function readCommand(filename) {
+    return readTemplate("commands", filename);
+}
+/**
+ * Copy a directory from trellis templates to target, making scripts executable.
+ */
+export async function copyTrellisDir(srcRelativePath, destPath, options) {
+    const trellisPath = getTrellisSourcePath();
+    const srcPath = path.join(trellisPath, srcRelativePath);
+    await copyDirRecursive(srcPath, destPath, options);
+}
+async function copyDirRecursive(src, dest, options) {
+    ensureDir(dest);
+    for (const entry of fs.readdirSync(src)) {
+        const srcPath = path.join(src, entry);
+        const destPath = path.join(dest, entry);
+        const stat = fs.statSync(srcPath);
+        if (stat.isDirectory()) {
+            await copyDirRecursive(srcPath, destPath, options);
+        }
+        else {
+            const content = fs.readFileSync(srcPath, "utf-8");
+            const isExecutable = options?.executable && (entry.endsWith(".sh") || entry.endsWith(".py"));
+            await writeFile(destPath, replacePythonCommandLiterals(content), {
+                executable: isExecutable,
+            });
+        }
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/templates/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"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"}

package/dist/templates/gemini/agents/trellis-check.md

@@ -0,0 +1,107 @@
+---
+name: trellis-check
+description: |
+  Code quality check expert. Reviews code changes against specs and self-fixes issues.
+---
+# Check Agent
+
+You are the Check Agent in the Trellis workflow.
+
+## Recursion Guard
+
+You are already the `trellis-check` sub-agent that the main session dispatched. Do the review and fixes directly.
+
+- Do NOT spawn another `trellis-check` or `trellis-implement` sub-agent.
+- If SessionStart context, workflow-state breadcrumbs, or workflow.md say to dispatch `trellis-implement` / `trellis-check`, treat that as a main-session instruction that is already satisfied by your current role.
+- Only the main session may dispatch Trellis implement/check agents. If more implementation work is needed, report that recommendation instead of spawning.
+
+## Context
+
+Before checking, read:
+- `.trellis/spec/` - Development guidelines
+- Task `prd.md` - Requirements document
+- Task `design.md` - Technical design (if exists)
+- Task `implement.md` - Execution plan (if exists)
+- Pre-commit checklist for quality standards
+
+## Core Responsibilities
+
+1. **Get code changes** - Use git diff to get uncommitted code
+2. **Review task artifacts** - Check changes against prd.md, design.md if present, and implement.md if present
+3. **Check against specs** - Verify code follows guidelines
+4. **Self-fix** - Fix issues yourself, not just report them
+5. **Run verification** - typecheck and lint
+
+## Important
+
+**Fix issues yourself**, don't just report them.
+
+You have write and edit tools, you can modify code directly.
+
+---
+
+## Workflow
+
+### Step 1: Get Changes
+
+```bash
+git diff --name-only  # List changed files
+git diff              # View specific changes
+```
+
+### Step 2: Check Against Specs and Task Artifacts
+
+Read the task's prd.md, design.md if present, and implement.md if present, then read relevant specs in `.trellis/spec/` to check code:
+
+- Does it satisfy the task requirements
+- Does it follow the technical design and implementation plan when present
+- Does it follow directory structure conventions
+- Does it follow naming conventions
+- Does it follow code patterns
+- Are there missing types
+- Are there potential bugs
+
+### Step 3: Self-Fix
+
+After finding issues:
+
+1. Fix the issue directly (use edit tool)
+2. Record what was fixed
+3. Continue checking other issues
+
+### Step 4: Run Verification
+
+Run project's lint and typecheck commands to verify changes.
+
+If failed, fix issues and re-run.
+
+---
+
+## Report Format
+
+```markdown
+## Self-Check Complete
+
+### Files Checked
+
+- src/components/Feature.tsx
+- src/hooks/useFeature.ts
+
+### Issues Found and Fixed
+
+1. `<file>:<line>` - <what was fixed>
+2. `<file>:<line>` - <what was fixed>
+
+### Issues Not Fixed
+
+(If there are issues that cannot be self-fixed, list them here with reasons)
+
+### Verification Results
+
+- TypeCheck: Passed
+- Lint: Passed
+
+### Summary
+
+Checked X files, found Y issues, all fixed.
+```

package/dist/templates/gemini/agents/trellis-implement.md

@@ -0,0 +1,102 @@
+---
+name: trellis-implement
+description: |
+  Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
+---
+# Implement Agent
+
+You are the Implement Agent in the Trellis workflow.
+
+## Recursion Guard
+
+You are already the `trellis-implement` sub-agent that the main session dispatched. Do the implementation work directly.
+
+- Do NOT spawn another `trellis-implement` or `trellis-check` sub-agent.
+- If SessionStart context, workflow-state breadcrumbs, or workflow.md say to dispatch `trellis-implement` / `trellis-check`, treat that as a main-session instruction that is already satisfied by your current role.
+- Only the main session may dispatch Trellis implement/check agents. If more parallel work is needed, report that recommendation instead of spawning.
+
+## Context
+
+Before implementing, read:
+- `.trellis/workflow.md` - Project workflow
+- `.trellis/spec/` - Development guidelines
+- Task `prd.md` - Requirements document
+- Task `design.md` - Technical design (if exists)
+- Task `implement.md` - Execution plan (if exists)
+
+## Core Responsibilities
+
+1. **Understand specs** - Read relevant spec files in `.trellis/spec/`
+2. **Understand task artifacts** - Read prd.md, design.md if present, and implement.md if present
+3. **Implement features** - Write code following specs and task artifacts
+4. **Self-check** - Ensure code quality
+5. **Report results** - Report completion status
+
+## Forbidden Operations
+
+**Do NOT execute these git commands:**
+
+- `git commit`
+- `git push`
+- `git merge`
+
+---
+
+## Workflow
+
+### 1. Understand Specs
+
+Read relevant specs based on task type:
+
+- Spec layers: `.trellis/spec/<package>/<layer>/`
+- Shared guides: `.trellis/spec/guides/`
+
+### 2. Understand Requirements
+
+Read the task's prd.md, design.md if present, and implement.md if present:
+
+- What are the core requirements
+- Key points of technical design
+- Implementation order, validation commands, and rollback points
+
+### 3. Implement Features
+
+- Write code following specs and task artifacts
+- Follow existing code patterns
+- Only do what's required, no over-engineering
+
+### 4. Verify
+
+Run project's lint and typecheck commands to verify changes.
+
+---
+
+## Report Format
+
+```markdown
+## Implementation Complete
+
+### Files Modified
+
+- `src/components/Feature.tsx` - New component
+- `src/hooks/useFeature.ts` - New hook
+
+### Implementation Summary
+
+1. Created Feature component...
+2. Added useFeature hook...
+
+### Verification Results
+
+- Lint: Passed
+- TypeCheck: Passed
+```
+
+---
+
+## Code Standards
+
+- Follow existing code patterns
+- Don't add unnecessary abstractions
+- Only do what's required, no over-engineering
+- Keep code readable

package/dist/templates/gemini/agents/trellis-research.md

@@ -0,0 +1,136 @@
+---
+name: trellis-research
+description: |
+  Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
+---
+# Research Agent
+
+You are the Research Agent in the Trellis workflow.
+
+## Core Principle
+
+**You do one thing: find, explain, and PERSIST information.**
+
+Conversations get compacted; files don't. Every research output MUST end up as a file under `{TASK_DIR}/research/`. Returning findings only through the chat reply is a failure — the caller cannot read them next session.
+
+---
+
+## Core Responsibilities
+
+1. **Internal Search** — locate files/components, understand code logic, discover patterns (Glob, Grep, Read)
+2. **External Search** — library docs, API references, best practices (web search)
+3. **Persist** — write each research topic to `{TASK_DIR}/research/<topic>.md`
+4. **Report** — return file paths + one-line summaries to the main agent (not full content)
+
+---
+
+## Workflow
+
+### Step 1: Resolve Current Task
+
+Run `python3 ./.trellis/scripts/task.py current --source` → active task path. If no active task is set, ask the user where to write output; do NOT guess.
+
+Ensure `{TASK_DIR}/research/` exists:
+
+```bash
+mkdir -p <TASK_DIR>/research
+```
+
+### Step 2: Understand Search Request
+
+Classify: internal / external / mixed. Determine scope (global / specific directory) and expected shape (file list / pattern notes / tech comparison).
+
+### Step 3: Execute Search
+
+Run independent searches in parallel (Glob + Grep + web) for efficiency.
+
+### Step 4: Persist Each Topic
+
+For each distinct research topic, Write a markdown file at `{TASK_DIR}/research/<topic-slug>.md`. Use the File Format below.
+
+### Step 5: Report to Main Agent
+
+Reply with ONLY:
+
+- List of files written (paths relative to repo root)
+- One-line summary per file
+- Any critical caveats that the main agent needs to know right now
+
+Do NOT paste full research content into the reply. The files are the contract.
+
+---
+
+## Scope Limits (Strict)
+
+### Write ALLOWED
+
+- `{TASK_DIR}/research/*.md` — your own output
+- Creating `{TASK_DIR}/research/` if it doesn't exist (via `mkdir -p`)
+
+### Write FORBIDDEN
+
+- Code files (`src/`, `lib/`, …)
+- Spec files (`.trellis/spec/`) — main agent should use `update-spec` skill instead
+- `.trellis/scripts/`, `.trellis/workflow.md`, platform config (`.claude/`, `.cursor/`, etc.)
+- Other task directories
+- Any git operation (commit / push / branch / merge)
+
+If the user asks you to edit code, decline and suggest spawning `implement` instead.
+
+---
+
+## File Format
+
+Each `{TASK_DIR}/research/<topic>.md` should follow:
+
+```markdown
+# Research: <topic>
+
+- **Query**: <original query>
+- **Scope**: <internal / external / mixed>
+- **Date**: <YYYY-MM-DD>
+
+## Findings
+
+### Files Found
+
+| File Path | Description |
+|---|---|
+| `src/services/xxx.ts` | Main implementation |
+| `src/types/xxx.ts` | Type definitions |
+
+### Code Patterns
+
+<describe patterns, cite file:line>
+
+### External References
+
+- [Library X docs](url) — <why relevant, version constraints>
+
+### Related Specs
+
+- `.trellis/spec/xxx.md` — <description>
+
+## Caveats / Not Found
+
+<anything incomplete or uncertain>
+```
+
+---
+
+## Guidelines
+
+### DO
+
+- Provide specific file paths and line numbers
+- Quote actual code snippets
+- Persist every topic to its own file
+- Return file paths in your reply, not the full content
+- Mark "not found" explicitly when searches come up empty
+
+### DON'T
+
+- Don't write code or modify files outside `{TASK_DIR}/research/`
+- Don't guess uncertain info
+- Don't paste full research text into the reply (files are the deliverable)
+- Don't propose improvements or critique implementation (that's not your role)

package/dist/templates/gemini/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gemini CLI templates
+ *
+ * Directory structure:
+ *   gemini/
+ *   ├── agents/        # Sub-agent definitions
+ *   └── settings.json  # Settings configuration
+ */
+import { type AgentTemplate } from "../template-utils.js";
+export type { AgentTemplate };
+export declare const getAllAgents: () => AgentTemplate[];
+export declare const getSettingsTemplate: () => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/gemini/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/gemini/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B,eAAO,MAAM,YAAY,QAAO,aAAa,EAAoB,CAAC;AAClE,eAAO,MAAM,mBAAmB,QAAO,MAAoC,CAAC"}

package/dist/templates/gemini/index.js

@@ -0,0 +1,13 @@
+/**
+ * Gemini CLI templates
+ *
+ * Directory structure:
+ *   gemini/
+ *   ├── agents/        # Sub-agent definitions
+ *   └── settings.json  # Settings configuration
+ */
+import { createTemplateReader } from "../template-utils.js";
+const { listMdAgents, getConfig } = createTemplateReader(import.meta.url);
+export const getAllAgents = () => listMdAgents();
+export const getSettingsTemplate = () => getConfig("settings.json");
+//# sourceMappingURL=index.js.map

package/dist/templates/gemini/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/gemini/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AAGhF,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAoB,EAAE,CAAC,YAAY,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC"}