heyarchie-cli 0.1.0__tar.gz

heyarchie_cli-0.1.0/.gitignore

@@ -0,0 +1,217 @@
+# Agent 365 CLI generated config — contains plaintext client secret on non-Windows
+a365.generated.config.json
+# Root-level a365.config.json auto-created by CLI; canonical config lives at apps/api/a365.config.json
+/a365.config.json
+
+# Node.js dependencies
+node_modules/
+**/node_modules/
+
+# pnpm
+.pnpm-store/
+
+
+# Linear Integration
+.env
+.env.*
+!.env.example
+!.env.vault.example
+!.env.test
+!.env.observability.example
+linear-tickets.json
+linear-issue-mapping.json
+*.tickets.json
+.cloudflare_credentials
+
+# Deleted orchestrator — V2 killed, V3 renamed to orchestrator/. Never re-add.
+**/orchestrator_v3/
+**/orchestrator_v2/
+
+# Workstream Studio build artifacts + Playwright run output. Never commit.
+apps/workstream-studio/dist/
+apps/workstream-studio/e2e/screenshots/
+apps/workstream-studio/e2e/test-results/
+apps/workstream-studio/playwright-report/
+apps/workstream-studio/test-results/
+
+# Python Environment (UV + Ruff)
+.venv/
+venv/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+pip-log.txt
+pip-delete-this-directory.txt
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+.hypothesis/
+
+# File Ingestion Service - Test files and uploads
+src/services/file-ingestion/test_*.py
+src/services/file-ingestion/test_*.json
+src/services/file-ingestion/data/uploads/
+src/services/file-ingestion/seeds/
+src/services/file-ingestion/examples/
+
+# Test scripts and temporary files (root level only, not in tests/ directories)
+/test_*.py
+/test-*.sh
+/start-*.sh
+/stop-*.sh
+
+# macOS
+.DS_Store
+
+# Vite build artifacts
+**/node_modules/.vite/
+**/node_modules/.vite/deps_temp_*
+
+# Build artifacts
+/dist
+apps/teams/dist/
+
+# .NET build output
+**/bin/
+**/obj/
+
+# Terraform local environments
+/terraform/environments/dev
+
+# Playwright test results and reports
+test-results/
+playwright-report/
+
+# Claude Flow generated files
+.claude/settings.local.json
+.mcp.json
+claude-flow.config.json
+.swarm/
+.hive-mind/
+.claude-flow/
+memory/
+coordination/
+# Allow the orchestrator memory module (Python package, not claude-flow data)
+!apps/api/src/orchestrator/memory/
+# Same module after the V4 consolidation move (Epic 14 issue #3517).
+!apps/api/src/orchestrator/v4/memory/
+# Allow the scoped memory services module (Epic aemm00l)
+!apps/api/src/services/memory/
+# Allow memory unit tests
+!tests/unit/memory/
+!apps/api/tests/orchestrator/memory/
+memory/claude-flow-data.json
+memory/sessions/*
+!memory/sessions/README.md
+memory/agents/*
+!memory/agents/README.md
+coordination/memory_bank/*
+coordination/subtasks/*
+coordination/orchestration/*
+*.db
+*.db-journal
+*.db-wal
+*.sqlite
+*.sqlite-journal
+*.sqlite-wal
+claude-flow
+# Removed Windows wrapper files per user request
+hive-mind-prompt-*.txt
+
+# Infrastructure files with secrets (do not commit)
+infrastructure/docker/migration-job.yaml
+
+# Playwright auth state (generated at runtime, contains session tokens)
+tests/e2e/.auth/user.json
+tests/smoke/.auth/user.json
+
+# Frontend lock file
+apps/frontend/package-lock.json
+
+# Martha test workflow tracker
+.test-tracker.json
+
+# Worktree-specific configuration
+.worktree-config.json
+
+# Test reports (generated by pytest)
+apps/api/reports/
+**/reports/*.xml
+**/reports/*.html
+.env.copilot-tests
+
+# Sidebar v2 sample files (do not commit)
+.archie-sidebar-v2-samples/
+~/.archie-sidebar-v2-samples/
+
+# GitHub Actions local secrets
+.act.secrets
+
+# CEA manifest packages (built from manifest source files)
+apps/archie-m365/manifest/archie-cea-*.zip
+apps/archie-m365/manifest-da/archie-da-*.zip
+apps/api/static/archie-cea-*.zip
+
+# OpenAPI Generator CLI config (tool-specific)
+openapitools.json
+
+# Smoke test tracking
+.smoke-tracker.json
+
+# Render environment file (contains secrets - DO NOT COMMIT)
+env.render
+*.render.env
+
+# UI library build output
+packages/ui/dist/
+packages/ui/storybook-static/
+
+# Windows desktop app build artifacts (Inno Setup installer + staging)
+apps/archie-desktop-win/dist/
+apps/archie-desktop-win/ArchieDesktop/bin/
+apps/archie-desktop-win/ArchieDesktop/obj/
+
+# Script output (locale comparisons, debug exports)
+scripts/output/
+
+# Rust/Tauri build artifacts
+**/target/
+**/src-tauri/target/
+Cargo.lock
+!apps/workstreams-studio/src-tauri/Cargo.lock
+
+# Auto-generated by sprite executor
+.claude-task-*
+.claude/worktrees/
+
+# Deleted standalone orchestrator service — do not re-add
+services/orchestrator/
+.claude/plans/
+.claude/scheduled_tasks.lock
+# Playwright MCP browser test artifacts
+.playwright-mcp/
+apps/developers-portal/.next
+tsconfig.tsbuildinfo
+apps/developers-portal/next-env.d.ts
+
+# Martha active-issue marker (per-session, never tracked)
+.claude/active-issue
+.claude/.turn-needs-martha
+.claude/.last-martha-update
+
+# Orchestrator V4 autonomous build loop — append-only journal + pause flag
+# Journal lives at worktree root (not .claude/) so it bypasses Claude Code's
+# .claude/ sensitivity prompts.
+orchv4-build-journal.md
+orchv4-interior-journal.md
+.claude/orchv4-PAUSE
+.claude/orchv4-interior-PAUSE
+.env.test
+.alpha-deploy-state/

heyarchie_cli-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: heyarchie-cli
+Version: 0.1.0
+Summary: Command-line interface for the Archie Connect platform — workstreams, cycles, skills.
+Project-URL: Homepage, https://developers.heyarchie.ai
+Project-URL: Documentation, https://developers.heyarchie.ai/docs/cli
+Project-URL: Source, https://github.com/heyarchie-ai/archie-platform-v2/tree/alpha/apps/cli
+Author-email: Archie <hey@archie.ai>
+License: Proprietary
+Keywords: archie,cli,connect,workstreams
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.11
+Requires-Dist: click<9.0,>=8.1
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: rich<14.0,>=13.7
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# archie CLI
+
+Command-line interface for the Archie Connect platform.
+
+## Install
+
+```bash
+# from PyPI (when published)
+pipx install heyarchie-cli
+
+# or from this repo for development
+pip install -e apps/cli
+```
+
+`pipx` is recommended; it installs `archie` as a self-contained executable on
+your PATH without touching system Python packages.
+
+## Authenticate
+
+```bash
+archie login --api-url https://api.heyarchie.ai
+# Then paste your bearer token at the prompt (input is hidden).
+```
+
+This writes `~/.archie/credentials.toml` (chmod 600) under the `[default]`
+profile. Override per-call with `--profile`, `--api-key`, or env vars
+`ARCHIE_API_KEY` / `ARCHIE_API_URL`.
+
+> Today the bearer must be an **Archie session JWT** or **Archie OAuth JWT**.
+> WorkOS-issued `sk_*` API keys are not yet validated server-side — see
+> [`docs/connect/api-keys-flow.md`](../../docs/connect/api-keys-flow.md) for
+> the architectural decision pending.
+
+## Commands
+
+```text
+archie login                                 Save bearer credentials.
+archie workstreams list [--scope ...]        List visible workstreams.
+archie workstreams describe <id>             Show metadata + step graph.
+archie workstreams run <id> [--var k=v]      Start a cycle.
+archie workstreams status <cycle_id>         Show cycle progress.
+archie workstreams cancel <cycle_id>         Cancel a running cycle.
+archie workstreams logs <cycle_id>           Stream SSE events live.
+```
+
+`workstream_id` accepts a UUID, a workstream slug, or a 7-char permakey;
+the API resolves all three.
+
+## Examples
+
+```bash
+# List workstreams
+archie workstreams list
+
+# JSON output (pipe-friendly)
+archie workstreams list --json | jq '.items[].permakey'
+
+# Start a cycle and watch it run
+CYCLE=$(archie workstreams run abc1234 --period 2026-Q1 --json | jq -r .cycle_id)
+archie workstreams logs "$CYCLE"
+```
+
+## Environment variables
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `ARCHIE_API_URL` | API base URL | `https://api.heyarchie.ai` |
+| `ARCHIE_API_KEY` | Bearer token | (none) |
+
+CLI flags take precedence over env, which takes precedence over the
+on-disk credentials file.
+
+## Where this lives
+
+`apps/cli/` in the `archie-platform-v2` monorepo. PRs welcome.

heyarchie_cli-0.1.0/README.md

@@ -0,0 +1,75 @@
+# archie CLI
+
+Command-line interface for the Archie Connect platform.
+
+## Install
+
+```bash
+# from PyPI (when published)
+pipx install heyarchie-cli
+
+# or from this repo for development
+pip install -e apps/cli
+```
+
+`pipx` is recommended; it installs `archie` as a self-contained executable on
+your PATH without touching system Python packages.
+
+## Authenticate
+
+```bash
+archie login --api-url https://api.heyarchie.ai
+# Then paste your bearer token at the prompt (input is hidden).
+```
+
+This writes `~/.archie/credentials.toml` (chmod 600) under the `[default]`
+profile. Override per-call with `--profile`, `--api-key`, or env vars
+`ARCHIE_API_KEY` / `ARCHIE_API_URL`.
+
+> Today the bearer must be an **Archie session JWT** or **Archie OAuth JWT**.
+> WorkOS-issued `sk_*` API keys are not yet validated server-side — see
+> [`docs/connect/api-keys-flow.md`](../../docs/connect/api-keys-flow.md) for
+> the architectural decision pending.
+
+## Commands
+
+```text
+archie login                                 Save bearer credentials.
+archie workstreams list [--scope ...]        List visible workstreams.
+archie workstreams describe <id>             Show metadata + step graph.
+archie workstreams run <id> [--var k=v]      Start a cycle.
+archie workstreams status <cycle_id>         Show cycle progress.
+archie workstreams cancel <cycle_id>         Cancel a running cycle.
+archie workstreams logs <cycle_id>           Stream SSE events live.
+```
+
+`workstream_id` accepts a UUID, a workstream slug, or a 7-char permakey;
+the API resolves all three.
+
+## Examples
+
+```bash
+# List workstreams
+archie workstreams list
+
+# JSON output (pipe-friendly)
+archie workstreams list --json | jq '.items[].permakey'
+
+# Start a cycle and watch it run
+CYCLE=$(archie workstreams run abc1234 --period 2026-Q1 --json | jq -r .cycle_id)
+archie workstreams logs "$CYCLE"
+```
+
+## Environment variables
+
+| Variable | Purpose | Default |
+|---|---|---|
+| `ARCHIE_API_URL` | API base URL | `https://api.heyarchie.ai` |
+| `ARCHIE_API_KEY` | Bearer token | (none) |
+
+CLI flags take precedence over env, which takes precedence over the
+on-disk credentials file.
+
+## Where this lives
+
+`apps/cli/` in the `archie-platform-v2` monorepo. PRs welcome.

heyarchie_cli-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "heyarchie-cli"
+version = "0.1.0"
+description = "Command-line interface for the Archie Connect platform — workstreams, cycles, skills."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Proprietary" }
+authors = [{ name = "Archie", email = "hey@archie.ai" }]
+keywords = ["archie", "connect", "cli", "workstreams"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Accounting",
+]
+dependencies = [
+    "click>=8.1,<9.0",
+    "httpx>=0.27,<1.0",
+    "rich>=13.7,<14.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.6",
+]
+
+[project.urls]
+Homepage = "https://developers.heyarchie.ai"
+Documentation = "https://developers.heyarchie.ai/docs/cli"
+Source = "https://github.com/heyarchie-ai/archie-platform-v2/tree/alpha/apps/cli"
+
+[project.scripts]
+archie = "archie_cli.__main__:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/archie_cli"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "RUF"]
+ignore = ["E501"]

heyarchie_cli-0.1.0/src/archie_cli/__init__.py

@@ -0,0 +1,12 @@
+"""Archie Connect CLI — `archie` console script.
+
+Surfaces the Connect platform as terminal commands. Read-friendly when
+attached to a TTY (rich-rendered tables, colors); machine-friendly when
+piped (`--json`).
+
+Auth is bearer-only today: an Archie session JWT or an Archie OAuth JWT.
+WorkOS-managed `sk_*` API keys are not yet validated server-side — see
+`docs/connect/api-keys-flow.md` for the architectural decision pending.
+"""
+
+__version__ = "0.1.0"

heyarchie_cli-0.1.0/src/archie_cli/__main__.py

@@ -0,0 +1,35 @@
+"""``archie`` console-script entry point."""
+
+from __future__ import annotations
+
+import click
+
+from archie_cli import __version__
+from archie_cli.cmds.login import login_cmd
+from archie_cli.cmds.skills import skills_group
+from archie_cli.cmds.workstreams import workstreams_group
+
+
+@click.group(
+    help=(
+        "Archie Connect CLI.\n\n"
+        "Read-friendly when attached to a TTY; pipe-friendly with --json.\n"
+        "Auth: bearer token via --api-key, env ARCHIE_API_KEY, or `archie login`."
+    )
+)
+@click.version_option(__version__, prog_name="archie")
+def cli() -> None:
+    """archie — Connect CLI."""
+
+
+cli.add_command(login_cmd)
+cli.add_command(skills_group)
+cli.add_command(workstreams_group)
+
+
+def main() -> None:
+    cli()
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

heyarchie_cli-0.1.0/src/archie_cli/auth.py

@@ -0,0 +1,101 @@
+"""Credential storage for the `archie` CLI.
+
+Lookup order: explicit flag → env var → on-disk credentials → prompt the
+user. The on-disk file at ``~/.archie/credentials.toml`` is chmod 600.
+"""
+
+from __future__ import annotations
+
+import os
+import stat
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+
+try:
+    import tomllib  # py311+
+except ImportError:  # pragma: no cover
+    import tomli as tomllib  # type: ignore[no-redef]
+
+
+CREDENTIALS_PATH = Path.home() / ".archie" / "credentials.toml"
+DEFAULT_PROFILE = "default"
+DEFAULT_API_URL = "https://api.heyarchie.ai"
+
+
+@dataclass(frozen=True)
+class Credentials:
+    """Resolved CLI credentials."""
+
+    api_url: str
+    api_key: str
+    profile: str
+
+
+class CredentialError(Exception):
+    """Raised when credentials are missing or unreadable."""
+
+
+def load_credentials(
+    *,
+    profile: str = DEFAULT_PROFILE,
+    api_url_override: str | None = None,
+    api_key_override: str | None = None,
+) -> Credentials:
+    """Resolve credentials, preferring explicit overrides → env → on-disk."""
+    api_url = (
+        api_url_override
+        or os.environ.get("ARCHIE_API_URL")
+        or _from_disk(profile, "api_url")
+        or DEFAULT_API_URL
+    )
+    api_key = api_key_override or os.environ.get("ARCHIE_API_KEY") or _from_disk(profile, "api_key")
+    if not api_key:
+        raise CredentialError(
+            "No API key found. Set ARCHIE_API_KEY, run `archie login`, or pass --api-key."
+        )
+    return Credentials(api_url=api_url.rstrip("/"), api_key=api_key, profile=profile)
+
+
+def save_credentials(api_url: str, api_key: str, *, profile: str = DEFAULT_PROFILE) -> Path:
+    """Persist credentials to ``~/.archie/credentials.toml`` (chmod 600)."""
+    CREDENTIALS_PATH.parent.mkdir(parents=True, exist_ok=True)
+    existing: dict[str, dict[str, str]] = {}
+    if CREDENTIALS_PATH.exists():
+        try:
+            with CREDENTIALS_PATH.open("rb") as fh:
+                existing = tomllib.load(fh)  # type: ignore[assignment]
+        except Exception:  # pragma: no cover — corrupt file → overwrite
+            existing = {}
+    existing[profile] = {"api_url": api_url.rstrip("/"), "api_key": api_key}
+    text = _render_toml(existing)
+    CREDENTIALS_PATH.write_text(text)
+    os.chmod(CREDENTIALS_PATH, stat.S_IRUSR | stat.S_IWUSR)
+    return CREDENTIALS_PATH
+
+
+def _from_disk(profile: str, key: str) -> str | None:
+    if not CREDENTIALS_PATH.exists():
+        return None
+    try:
+        with CREDENTIALS_PATH.open("rb") as fh:
+            data = tomllib.load(fh)
+    except Exception as exc:  # pragma: no cover
+        print(f"warning: failed to read {CREDENTIALS_PATH}: {exc}", file=sys.stderr)
+        return None
+    section = data.get(profile)
+    if not isinstance(section, dict):
+        return None
+    value = section.get(key)
+    return str(value) if value else None
+
+
+def _render_toml(data: dict[str, dict[str, str]]) -> str:
+    out: list[str] = []
+    for profile, fields in sorted(data.items()):
+        out.append(f"[{profile}]")
+        for k in sorted(fields):
+            v = fields[k].replace('"', '\\"')
+            out.append(f'{k} = "{v}"')
+        out.append("")
+    return "\n".join(out)