@claushaas/ergon-cli 0.1.2

package/dist/config/index.js

@@ -0,0 +1,76 @@
+import path from 'node:path';
+import { loadProjectLibraryMetadata, resolveProjectPaths, } from '../project.js';
+function readStringEnv(name) {
+    const value = process.env[name]?.trim();
+    return value ? value : undefined;
+}
+function splitArgs(value) {
+    return value?.split(/\s+/).filter((entry) => entry.length > 0);
+}
+export function loadCliConfig(cwd = process.cwd()) {
+    const ergonRootDir = readStringEnv('ERGON_ROOT_DIR');
+    const ergonDbPath = readStringEnv('ERGON_DB_PATH');
+    const claudeCodeCommand = readStringEnv('CLAUDE_CODE_COMMAND');
+    const claudeCodeArgs = readStringEnv('CLAUDE_CODE_ARGS');
+    const codexCommand = readStringEnv('CODEX_COMMAND');
+    const codexArgs = readStringEnv('CODEX_ARGS');
+    const ollamaBaseUrl = readStringEnv('OLLAMA_BASE_URL');
+    const ollamaModel = readStringEnv('OLLAMA_MODEL');
+    const openClawCommand = readStringEnv('OPENCLAW_COMMAND');
+    const openClawArgs = readStringEnv('OPENCLAW_ARGS');
+    const openRouterApiKey = readStringEnv('OPENROUTER_API_KEY');
+    const openRouterAppName = readStringEnv('OPENROUTER_APP_NAME');
+    const openRouterBaseUrl = readStringEnv('OPENROUTER_BASE_URL');
+    const openRouterModel = readStringEnv('OPENROUTER_MODEL');
+    const openRouterSiteUrl = readStringEnv('OPENROUTER_SITE_URL');
+    const project = resolveProjectPaths(cwd, ergonRootDir);
+    return {
+        configPath: project.configPath,
+        dbPath: path.resolve(project.rootDir, ergonDbPath ?? '.ergon/storage/ergon.db'),
+        embeddedLibraryDir: project.embeddedLibraryDir,
+        embeddedWorkflowsDir: project.embeddedWorkflowsDir,
+        ergonDir: project.ergonDir,
+        initialized: project.initialized,
+        libraryDir: project.libraryDir,
+        projectMetadata: loadProjectLibraryMetadata(project),
+        providerConfigs: {
+            'claude-code': claudeCodeCommand || claudeCodeArgs
+                ? {
+                    args: splitArgs(claudeCodeArgs),
+                    command: claudeCodeCommand,
+                }
+                : undefined,
+            codex: codexCommand || codexArgs
+                ? {
+                    args: splitArgs(codexArgs),
+                    command: codexCommand,
+                }
+                : undefined,
+            ollama: ollamaBaseUrl || ollamaModel
+                ? {
+                    baseUrl: ollamaBaseUrl,
+                    defaultModel: ollamaModel,
+                }
+                : undefined,
+            openclaw: openClawCommand || openClawArgs
+                ? {
+                    args: splitArgs(openClawArgs),
+                    command: openClawCommand,
+                }
+                : undefined,
+            openrouter: openRouterApiKey
+                ? {
+                    apiKey: openRouterApiKey,
+                    appName: openRouterAppName,
+                    baseUrl: openRouterBaseUrl,
+                    defaultModel: openRouterModel,
+                    siteUrl: openRouterSiteUrl,
+                }
+                : undefined,
+        },
+        rootDir: project.rootDir,
+        storageDir: project.storageDir,
+        workflowsDir: project.workflowsDir,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,3 @@
+export declare function getCliHelpText(): string;
+export declare function getCliVersionText(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,IAAI,MAAM,CAuCvC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/help.js

@@ -0,0 +1,45 @@
+import { getCliVersion } from './project.js';
+export function getCliHelpText() {
+    return `Ergon Flow CLI
+
+Install:
+  pnpm add -g @claushaas/ergon-cli
+
+Usage:
+  ergon init [--root <path>]
+  ergon library sync [--force] [--root <path>]
+  ergon template list
+  ergon workflow list
+  ergon run <workflow_id> [--inputs <json-or-path>]
+  ergon run-status <run_id>
+  ergon worker start [runtime flags]
+  ergon approve <run_id> <step_id> --decision approve|reject
+  ergon cancel <run_id>
+
+Bootstrap:
+  "ergon init" creates ./.ergon, copies the embedded library into
+  ./.ergon/library, and configures local storage at ./.ergon/storage/ergon.db.
+
+Initialization rules:
+  "template list", "--help", and "--version" work before initialization.
+  Stateful commands require an initialized .ergon project.
+
+Provider configuration:
+  ERGON_ROOT_DIR
+  ERGON_DB_PATH
+  OPENROUTER_API_KEY
+  OPENROUTER_BASE_URL
+  OPENROUTER_MODEL
+  OLLAMA_BASE_URL
+  OLLAMA_MODEL
+  CODEX_COMMAND
+  CODEX_ARGS
+  CLAUDE_CODE_COMMAND
+  CLAUDE_CODE_ARGS
+  OPENCLAW_COMMAND
+  OPENCLAW_ARGS`;
+}
+export function getCliVersionText() {
+    return getCliVersion();
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,cAAc;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAqCQ,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,OAAO,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/library/agents/coder.yaml

@@ -0,0 +1,27 @@
+
+id: coder
+kind: model
+provider: openrouter
+model: deepseek/deepseek-v3.2-speciale
+
+capabilities:
+  - code_patch
+  - diff_generation
+  - long_context
+
+settings:
+  temperature: 0.1
+  max_tokens: 32000
+  reasoning: true
+
+execution:
+  retries: 2
+  timeout_seconds: 600
+
+output:
+  schema: agent.patch.v1
+
+notes: |
+  Primary coding agent responsible for generating unified diff patches.
+  This agent receives implementation plans and produces code modifications
+  as structured patch artifacts conforming to the agent.patch.v1 schema.

package/dist/library/agents/pr-writer.yaml

@@ -0,0 +1,28 @@
+id: pr-writer
+kind: model
+provider: openrouter
+model: deepseek/deepseek-v3.2
+
+capabilities:
+  - pr_description
+  - change_summary
+  - commit_context
+
+settings:
+  temperature: 0.2
+  max_tokens: 16000
+  reasoning: true
+
+execution:
+  retries: 2
+  timeout_seconds: 300
+
+output:
+  schema: agent.pr.v1
+
+notes: |
+  Agent responsible for producing structured pull request metadata after
+  code changes are generated. It receives context such as patch summary,
+  implementation plan, and analysis results, and produces a complete
+  pull request artifact including title, body, labels, reviewers, and
+  branch metadata conforming to the agent.pr.v1 schema.

package/dist/library/agents/repo-analyzer.yaml

@@ -0,0 +1,31 @@
+id: repo-analyzer
+kind: model
+provider: openrouter
+model: deepseek/deepseek-v3.2
+
+capabilities:
+  - repository_analysis
+  - architecture_understanding
+  - dependency_mapping
+  - codebase_summarization
+
+settings:
+  temperature: 0.2
+  max_tokens: 32000
+  reasoning: true
+
+execution:
+  retries: 2
+  timeout_seconds: 600
+
+output:
+  schema: agent.analysis.v1
+
+notes: |
+  Agent responsible for analyzing a repository before planning or coding steps.
+  It inspects project structure, identifies relevant modules, dependencies,
+  architectural patterns, and potential impact areas for the requested change.
+
+  The output must conform to the agent.analysis.v1 schema and should highlight
+  affected components, relevant files, risks, and a clear summary that will
+  guide the planning phase of the workflow.

package/dist/library/agents/repo-planner.yaml

@@ -0,0 +1,35 @@
+id: repo-planner
+kind: model
+provider: openrouter
+model: deepseek/deepseek-v3.2
+
+capabilities:
+  - implementation_planning
+  - architecture_planning
+  - change_scoping
+  - dependency_awareness
+
+settings:
+  temperature: 0.2
+  max_tokens: 32000
+  reasoning: true
+
+execution:
+  retries: 2
+  timeout_seconds: 600
+
+output:
+  schema: agent.plan.v1
+
+notes: |
+  Agent responsible for transforming repository analysis into a concrete
+  implementation plan. It receives the output from repo-analyzer and
+  produces a structured plan describing how the change should be
+  implemented.
+
+  The plan must define the implementation strategy, the ordered steps
+  required to implement the change, the files expected to be affected,
+  potential risks, and a testing strategy.
+
+  The output must conform to the agent.plan.v1 schema and will be used
+  directly by coding agents to generate patches.

package/dist/library/schemas/agent.analysis.v1.json

@@ -0,0 +1,51 @@
+{
+	"$id": "agent.analysis.v1",
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"additionalProperties": false,
+	"description": "Structured analysis produced by an agent step before planning or implementation.",
+	"properties": {
+		"affected_components": {
+			"description": "List of components, modules, or areas affected.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"diagnosis": {
+			"description": "Detailed explanation of the current state or problem.",
+			"type": "string"
+		},
+		"files": {
+			"description": "List of relevant files identified during analysis.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"notes": {
+			"description": "Additional observations useful for later steps.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"risks": {
+			"description": "Potential risks identified during the analysis.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"root_cause": {
+			"description": "Identified root cause when applicable.",
+			"type": "string"
+		},
+		"summary": {
+			"description": "High level summary of the analysis.",
+			"type": "string"
+		}
+	},
+	"required": ["summary"],
+	"title": "Agent Analysis Artifact",
+	"type": "object"
+}

package/dist/library/schemas/agent.patch.v1.json

@@ -0,0 +1,57 @@
+{
+	"$id": "agent.patch.v1",
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"additionalProperties": false,
+	"description": "Structured patch produced by a coding agent representing file modifications.",
+	"properties": {
+		"breaking_changes": {
+			"default": false,
+			"description": "Indicates if the patch introduces breaking changes.",
+			"type": "boolean"
+		},
+		"files_added": {
+			"description": "List of newly created files.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"files_deleted": {
+			"description": "List of removed files.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"files_modified": {
+			"description": "List of files modified by the patch.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"notes": {
+			"description": "Additional implementation notes.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"patch": {
+			"description": "Unified diff patch representing the code changes.",
+			"type": "string"
+		},
+		"summary": {
+			"description": "Short description of the changes implemented.",
+			"type": "string"
+		},
+		"tests_added": {
+			"default": false,
+			"description": "Indicates whether tests were added or updated.",
+			"type": "boolean"
+		}
+	},
+	"required": ["summary", "patch"],
+	"title": "Agent Patch Artifact",
+	"type": "object"
+}

package/dist/library/schemas/agent.plan.v1.json

@@ -0,0 +1,71 @@
+{
+	"$id": "agent.plan.v1",
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"additionalProperties": false,
+	"description": "Structured implementation plan produced after analysis and before code modification steps.",
+	"properties": {
+		"affected_files": {
+			"description": "List of all files expected to be affected by the change.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"approach": {
+			"description": "Detailed explanation of the technical approach that will be used to implement the solution.",
+			"type": "string"
+		},
+		"notes": {
+			"description": "Additional notes that may help later steps such as coding or review.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"risks": {
+			"description": "Potential risks associated with the planned implementation.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"steps": {
+			"description": "Ordered list of implementation steps that will be executed.",
+			"items": {
+				"additionalProperties": false,
+				"properties": {
+					"description": {
+						"description": "Description of the step to be executed.",
+						"type": "string"
+					},
+					"files": {
+						"description": "Files expected to be modified or created in this step.",
+						"items": {
+							"type": "string"
+						},
+						"type": "array"
+					},
+					"type": {
+						"description": "Type of step being performed.",
+						"enum": ["modify", "create", "delete", "refactor", "test", "docs"],
+						"type": "string"
+					}
+				},
+				"required": ["description"],
+				"type": "object"
+			},
+			"type": "array"
+		},
+		"summary": {
+			"description": "Short summary of the implementation strategy.",
+			"type": "string"
+		},
+		"tests_strategy": {
+			"description": "Explanation of how the changes should be tested or validated.",
+			"type": "string"
+		}
+	},
+	"required": ["summary", "approach", "steps"],
+	"title": "Agent Plan Artifact",
+	"type": "object"
+}

package/dist/library/schemas/agent.pr.v1.json

@@ -0,0 +1,54 @@
+{
+	"$id": "agent.pr.v1",
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"additionalProperties": false,
+	"description": "Structured pull request metadata produced by an agent after generating or applying a patch.",
+	"properties": {
+		"base_branch": {
+			"description": "Base branch where the pull request should be opened (e.g., main or develop).",
+			"type": "string"
+		},
+		"body": {
+			"description": "Full pull request description including context, explanation of changes, and testing notes.",
+			"type": "string"
+		},
+		"breaking_changes": {
+			"default": false,
+			"description": "Indicates whether the pull request introduces breaking changes.",
+			"type": "boolean"
+		},
+		"head_branch": {
+			"description": "Branch containing the changes produced by the workflow.",
+			"type": "string"
+		},
+		"labels": {
+			"description": "Optional labels that should be applied to the pull request.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"migration_notes": {
+			"description": "Optional notes explaining required migrations or upgrade steps.",
+			"type": "string"
+		},
+		"reviewers": {
+			"description": "Suggested reviewers for the pull request.",
+			"items": {
+				"type": "string"
+			},
+			"type": "array"
+		},
+		"summary": {
+			"description": "Short summary of the change suitable for dashboards or notifications.",
+			"type": "string"
+		},
+		"title": {
+			"description": "Title of the pull request.",
+			"type": "string"
+		}
+	},
+	"required": ["title", "body"],
+	"title": "Agent Pull Request Artifact",
+	"type": "object"
+}