@awak-app/simy-cli 0.1.0 → 0.1.2

package/README.md

@@ -7,13 +7,53 @@ npx @awak-app/simy-cli
 npm install -g @awak-app/simy-cli
 simy
 simy --daemon
+simy --no-tui
+simy --host https://simy.example.com
 ```
 
+The published CLI connects to `https://app.simy.one` by default. Use `--host`
+with an absolute SIMY Web origin for another deployment. Non-loopback hosts
+must use HTTPS. `SIMY_WEB_ORIGIN` and the legacy `SIMY_API_ORIGIN` remain
+available for automation, but the command-line flag takes precedence.
+
 The CLI starts a loopback HTTP agent on a random available port, keeps a
-48-hour local session, and owns the coding-loop state machine when the SIMY
-web UI sends a backend-issued launch challenge. It builds the requirement
-charter, runs Codex or Claude Code, audits structured completion evidence, and
-re-instructs the executor within the configured attempt budget.
+48-hour, origin-scoped local session, and opens a native coding chat. The first
+chat message creates the remote audit ledger and starts the local coding-loop
+state machine; SIMY Web mirrors the lifecycle but is not required as the task
+entry point. The CLI also accepts backend-issued launch challenges for Web-led
+runs. It builds the requirement charter, runs Codex or Claude Code, audits
+structured completion evidence, and re-instructs the executor within the
+configured attempt budget.
+
+## Interactive console
+
+Running `simy` in a terminal opens the Coding Loop chat. It discovers the
+current GitHub repository and branch, selects an available executor, and keeps
+the composer active so a natural-language request can start immediately. Each
+run appears in a selectable list with its lifecycle state, process ID, and a
+bounded live transcript. Use `--no-tui` for the foreground HTTP-agent behavior
+or `--daemon` to run without the chat.
+
+The console supports these direct controls:
+
+- `Up`/`Down` or `j`/`k`: select a run.
+- `i`: enter human guidance. Guidance submitted while a provider process is
+  active is queued for the next executor handoff; a waiting run resumes as a
+  new attempt in the same lifecycle record.
+- `p`: pause or resume the selected local process on POSIX systems.
+- `r`: refresh pull request, review, and CI evidence.
+- `x`, then `x`: stop the selected run with confirmation.
+- `?`: show the command reference; `q`: leave the console.
+
+Use `/new`, `/repo <owner/name>`, `/branch <name>`, and
+`/executor <codex|claude>` to compose another task. `/attach <path>` adds a
+verified local file reference without copying or deleting the source file.
+Slash commands also provide explicit human gates: `/continue`, `/approve`,
+`/criteria`, `/checks`, `/recheck`, `/pause`, `/resume`, and `/stop`. Approval
+notes, acceptance criteria, and required checks are recorded in the run charter
+before orchestration continues. The console does not pretend that noninteractive
+`codex exec` or `claude -p` accepts mid-process stdin; active-run guidance is
+shown as queued until the next executor attempt.
 
 Structured run snapshots and process events are persisted remotely. Executor
 instructions and the latest bounded log lines are redacted at both the CLI and
@@ -41,6 +81,13 @@ Start `simy` from the selected repository or a workspace containing it. Set
 `SIMY_REPO_ROOT` when repositories live under a different root. The CLI
 verifies the checkout's GitHub `origin` before starting an executor.
 
+The real-PTY console E2E can be rerun with `npm run test:e2e:console`. It starts
+from an empty CLI chat, types repository, branch, executor, attachment, and task
+input through a pseudoterminal, creates the Web ledger, spawns real child
+processes, and exercises HIL plus lifecycle controls. It regenerates the
+screenshots, terminal frames, raw transcript, and SHA-256 manifest under
+`docs/pr-evidence/cli-coding-loop-console/`.
+
 ## Publishing
 
 Publishing is handled by GitHub Actions in `.github/workflows/publish.yml`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local SIMY coding-loop agent for Codex and Claude Code.",
   "type": "module",
   "bin": {
@@ -13,8 +13,12 @@
   "scripts": {
     "start": "node ./src/index.js",
     "test": "node --test",
-    "check": "npm run check:syntax && npm test && npm run check:package",
-    "check:syntax": "node --check ./src/index.js && node --check ./src/agent.js && node --check ./src/session-store.js && node --check ./src/orchestrator/index.js && node --check ./src/orchestrator/shared.js && node --check ./src/orchestrator/risk.js && node --check ./src/orchestrator/contract.js && node --check ./src/orchestrator/instruction.js && node --check ./src/orchestrator/execution-io.js && node --check ./src/orchestrator/result.js && node --check ./src/orchestrator/evidence.js && node --check ./src/orchestrator/independent-audit.js && node --check ./src/orchestrator/audit.js && node --check ./src/orchestrator/loop.js && node --check ./src/runner.js && node --check ./scripts/check-package-contents.js",
+    "test:e2e:console": "node ./scripts/console-e2e.js",
+    "test:e2e:console:real-provider": "node ./scripts/real-provider-console-e2e.js",
+    "test:e2e:console:fullstack": "node ./scripts/fullstack-cli-smoke.js",
+    "check": "npm run check:syntax && npm run check:real-provider-syntax && npm test && npm run check:package",
+    "check:real-provider-syntax": "node --check ./scripts/real-codex-probe.js && node --check ./scripts/real-claude-probe.js && node --check ./scripts/real-provider-console-fixture.js && node --check ./scripts/real-provider-console-e2e.js",
+    "check:syntax": "node --check ./src/index.js && node --check ./src/agent.js && node --check ./src/browser.js && node --check ./src/web-api.js && node --check ./src/run-registry.js && node --check ./src/backend-executable.js && node --check ./src/provider-stream.js && node --check ./src/console/index.js && node --check ./src/console/app.js && node --check ./src/console/commands.js && node --check ./src/local-attachments.js && node --check ./src/repository-inventory.js && node --check ./src/session-store.js && node --check ./src/web-origin.js && node --check ./src/workspace-context.js && node --check ./src/orchestrator/index.js && node --check ./src/orchestrator/shared.js && node --check ./src/orchestrator/risk.js && node --check ./src/orchestrator/contract.js && node --check ./src/orchestrator/instruction.js && node --check ./src/orchestrator/execution-io.js && node --check ./src/orchestrator/presentation.js && node --check ./src/orchestrator/result.js && node --check ./src/orchestrator/evidence.js && node --check ./src/orchestrator/independent-audit.js && node --check ./src/orchestrator/audit.js && node --check ./src/orchestrator/loop.js && node --check ./src/runner.js && node --check ./scripts/fixtures/fake-coding-backend.js && node --check ./scripts/console-e2e-fixture.js && node --check ./scripts/console-e2e.js && node --check ./scripts/real-provider-console-fixture.js && node --check ./scripts/real-provider-console-e2e.js && node --check ./scripts/fullstack-cli-smoke.js && node --check ./scripts/check-package-contents.js",
     "check:package": "node ./scripts/check-package-contents.js"
   },
   "engines": {
@@ -31,5 +35,14 @@
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "ink": "^6.8.0",
+    "react": "^19.2.0"
+  },
+  "devDependencies": {
+    "@xterm/headless": "^6.0.0",
+    "ink-testing-library": "^4.0.0",
+    "node-pty": "^1.1.0"
   }
 }