execforge 0.1.0__tar.gz → 0.1.2__tar.gz

{execforge-0.1.0/src/execforge.egg-info → execforge-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execforge
-Version: 0.1.0
+Version: 0.1.2
 Summary: Production-minded local CLI for autonomous repo orchestration
 Author: Open Source Contributors
 License: MIT License
@@ -63,6 +63,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -256,43 +259,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -337,25 +384,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.0 → execforge-0.1.2}/README.md

@@ -23,6 +23,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -216,43 +219,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -297,25 +344,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.0 → execforge-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "execforge"
-version = "0.1.0"
+version = "0.1.2"
 description = "Production-minded local CLI for autonomous repo orchestration"
 readme = "README.md"
 requires-python = ">=3.11"

{execforge-0.1.0 → execforge-0.1.2/src/execforge.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execforge
-Version: 0.1.0
+Version: 0.1.2
 Summary: Production-minded local CLI for autonomous repo orchestration
 Author: Open Source Contributors
 License: MIT License
@@ -63,6 +63,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -256,43 +259,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -337,25 +384,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.0 → execforge-0.1.2}/src/orchestrator/__init__.py

@@ -1,4 +1,4 @@
 """Repo orchestrator package."""
 
 __all__ = ["__version__"]
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{execforge-0.1.0 → execforge-0.1.2}/src/orchestrator/config.py

@@ -35,9 +35,6 @@ class AppConfig:
     default_timeout_seconds: int = 900
     default_require_clean_tree: bool = True
     default_allow_push: bool = False
-    claude_api_key: str | None = None
-    codex_api_key: str | None = None
-    opencode_api_key: str | None = None
 
 
 @dataclass(slots=True)
@@ -114,33 +111,18 @@ def get_config_schema() -> dict[str, ConfigFieldSpec]:
             default=False,
             description="Allow push by default",
         ),
-        "claude_api_key": ConfigFieldSpec(
-            key="claude_api_key",
-            value_type=str,
-            default=None,
-            sensitive=True,
-            description="Optional Claude API key",
-        ),
-        "codex_api_key": ConfigFieldSpec(
-            key="codex_api_key",
-            value_type=str,
-            default=None,
-            sensitive=True,
-            description="Optional Codex API key",
-        ),
-        "opencode_api_key": ConfigFieldSpec(
-            key="opencode_api_key",
-            value_type=str,
-            default=None,
-            sensitive=True,
-            description="Optional OpenCode API key",
-        ),
     }
 
 
 def get_app_paths() -> AppPaths:
-    override = os.environ.get("AGENT_ORCHESTRATOR_HOME") or os.environ.get("ORCHESTRATOR_HOME")
-    root = Path(override).expanduser() if override else Path(user_data_dir(APP_NAME, APP_NAME))
+    override = os.environ.get("AGENT_ORCHESTRATOR_HOME") or os.environ.get(
+        "ORCHESTRATOR_HOME"
+    )
+    root = (
+        Path(override).expanduser()
+        if override
+        else Path(user_data_dir(APP_NAME, APP_NAME))
+    )
     return AppPaths(
         root=root,
         db_file=root / "app.db",
@@ -209,13 +191,17 @@ def _serialize_toml(config: AppConfig) -> str:
 def save_config(paths: AppPaths, config: AppConfig) -> None:
     text = _serialize_toml(config)
     paths.config_file.parent.mkdir(parents=True, exist_ok=True)
-    with tempfile.NamedTemporaryFile("w", delete=False, encoding="utf-8", dir=str(paths.config_file.parent)) as tmp:
+    with tempfile.NamedTemporaryFile(
+        "w", delete=False, encoding="utf-8", dir=str(paths.config_file.parent)
+    ) as tmp:
         tmp.write(text)
         tmp_path = Path(tmp.name)
     tmp_path.replace(paths.config_file)
 
 
-def config_to_display_dict(config: AppConfig, mask_sensitive: bool = True) -> dict[str, Any]:
+def config_to_display_dict(
+    config: AppConfig, mask_sensitive: bool = True
+) -> dict[str, Any]:
     data = asdict(config)
     schema = get_config_schema()
     out: dict[str, Any] = {}
@@ -233,7 +219,9 @@ def update_config_values(paths: AppPaths, updates: dict[str, str]) -> AppConfig:
     unknown = [k for k in updates if k not in schema]
     if unknown:
         known = ", ".join(sorted(schema.keys()))
-        raise ConfigError(f"Unknown config key(s): {', '.join(unknown)}. Known keys: {known}")
+        raise ConfigError(
+            f"Unknown config key(s): {', '.join(unknown)}. Known keys: {known}"
+        )
 
     config = load_config(paths)
     data = asdict(config)