@awak-app/simy-cli 0.5.2 → 0.5.3

package/README.md

@@ -9,6 +9,14 @@ npm install -g @awak-app/simy-cli
 simy --daemon
 ```
 
+When an interactive `simy --daemon` starts and the managed SIMY workflows are
+missing or outdated, the CLI asks once before installing the Codex plugin
+marketplace, Codex/Claude SQM skills, and PR hooks. Existing unrelated plugins
+and hooks are preserved. Use `--install-workflows` for explicit non-interactive
+installation or `--no-workflow-prompt` to start the daemon without asking.
+After installation, restart Codex and install SIMY from **Plugins → Personal**
+before using `@simy` in a new task.
+
 This is the recommended installation because the CLI can safely install patch
 and minor releases, and the daemon restarts only when no Agentic Loop task is active. To run
 the interactive chat after installation, use `simy`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awak-app/simy-cli",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Local SIMY executor for non-coding Local Tasks and Agentic Loop runs.",
   "type": "module",
   "bin": {
@@ -38,7 +38,7 @@
     "test:e2e:console:fullstack": "node ./scripts/fullstack-cli-smoke.js",
     "check": "npm run check:auto-update && node --check ./src/desktop-executor.js && node --check ./src/local-task.js && node --check ./scripts/desktop-executor-e2e.js && node --check ./scripts/pre-guardrail-e2e.js && node --check ./scripts/fixtures/fake-desktop-provider.js && npm run check:syntax && npm run check:real-provider-syntax && npm test && npm run check:package",
     "check:auto-update": "node --check ./src/auto-update.js && node --check ./scripts/auto-update-e2e.js && npm run check:sqm",
-    "check:sqm": "node --check ./src/sqm/canonical.js && node --check ./src/sqm/validation.js && node --check ./src/sqm/reliability.js && node --check ./src/sqm/repository.js && node --check ./src/sqm/checkers.js && node --check ./src/sqm/bundle-store.js && node --check ./src/sqm/proof.js && node --check ./src/sqm/evidence-client.js && node --check ./src/sqm/session.js && node --check ./src/sqm/index.js && node --check ./src/sqm/command.js && node --check ./src/sqm/agent-skill.js && node --check ./src/sqm/review-worker.js && node --check ./scripts/sqm-complete-loop-e2e.js && node --check ./scripts/sqm-local-review-e2e.js",
+    "check:sqm": "node --check ./src/sqm/canonical.js && node --check ./src/sqm/validation.js && node --check ./src/sqm/reliability.js && node --check ./src/sqm/repository.js && node --check ./src/sqm/checkers.js && node --check ./src/sqm/bundle-store.js && node --check ./src/sqm/proof.js && node --check ./src/sqm/evidence-client.js && node --check ./src/sqm/session.js && node --check ./src/sqm/index.js && node --check ./src/sqm/command.js && node --check ./src/sqm/agent-skill.js && node --check ./src/sqm/workflow-onboarding.js && node --check ./src/sqm/review-worker.js && node --check ./scripts/sqm-complete-loop-e2e.js && node --check ./scripts/sqm-local-review-e2e.js",
     "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/durable-local-task-worker.js && node --check ./src/durable-local-task-steps-contract.js && node --check ./src/bounded-local-task-subtasks-contract.js && node --check ./src/bounded-local-task-subtask-pool.js && node --check ./src/local-task-artifact-contract.js && node --check ./src/execution-capability-contract.js && node --check ./src/shutdown.js && node --check ./src/run-registry.js && node --check ./src/direct-executor.js && node --check ./src/execution-guardrail.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/recovery.js && node --check ./src/orchestrator/risk.js && node --check ./src/orchestrator/contract.js && node --check ./src/orchestrator/completion-contract.js && node --check ./src/orchestrator/instruction.js && node --check ./src/orchestrator/problem-solving.js && node --check ./src/orchestrator/budget.js && node --check ./src/orchestrator/execution-io.js && node --check ./src/orchestrator/presentation.js && node --check ./src/orchestrator/result.js && node --check ./src/orchestrator/retry.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/completion-contract-fixture.js && node --check ./scripts/fixtures/fake-coding-backend.js && node --check ./scripts/e2e-terminal-evidence.js && node --check ./scripts/audit-gate-e2e.js && node --check ./scripts/completion-contract-e2e.js && node --check ./scripts/retry-circuit-e2e.js && node --check ./scripts/follow-up-charter-e2e.js && node --check ./scripts/task-routing-e2e.js && node --check ./scripts/executor-version-preflight-e2e.js && node --check ./scripts/blocked-recovery-e2e.js && node --check ./scripts/process-localization-e2e.js && node --check ./scripts/hypothesis-retries-e2e.js && node --check ./scripts/budget-enforcement-e2e.js && node --check ./scripts/local-task-default-workspace-e2e.js && node --check ./scripts/local-task-idempotency-e2e.js && node --check ./scripts/console-e2e-fixture.js && node --check ./scripts/console-e2e.js && node --check ./scripts/console-recovery-e2e-fixture.js && node --check ./scripts/console-recovery-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"

package/src/cli-contract.js

@@ -13,7 +13,7 @@ import {
 } from "./durable-local-task-steps-contract.js";
 import { buildExecutionCapabilityContract } from "./execution-capability-contract.js";
 
-export const CLI_VERSION = "0.5.2";
+export const CLI_VERSION = "0.5.3";
 export const CLI_API_CONTRACT_VERSION = 10;
 
 export function withCliContract(

package/src/index.js

@@ -19,6 +19,7 @@ import {
   createAgentShutdown,
   installAgentShutdownSignalHandlers,
 } from "./shutdown.js";
+import { prepareDaemonWorkflows } from "./sqm/workflow-onboarding.js";
 import { DEFAULT_WEB_ORIGIN, resolveWebOrigin } from "./web-origin.js";
 
 const argv = process.argv.slice(2);
@@ -101,6 +102,8 @@ Options:
   --no-open           Do not open the browser when authorization is required
   --port <port>       Bind a specific localhost port
   --host <url>        Connect to a SIMY Web origin (default: ${DEFAULT_WEB_ORIGIN})
+  --install-workflows Install or update SIMY Codex/Claude skills and PR hooks
+  --no-workflow-prompt Skip the daemon startup workflow-installation prompt
   --no-auto-update    Disable update checks and automatic installation
 
 ${autoUpdateHelpText()}
@@ -124,6 +127,14 @@ async function runLocalAgent() {
     return;
   }
 
+  try {
+    await prepareDaemonWorkflows({ argv, daemon });
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 2;
+    return;
+  }
+
   if (daemon && process.env.SIMY_DAEMON_CHILD !== "1") {
     const child = spawn(process.execPath, [fileURLToPath(import.meta.url), ...process.argv.slice(2)], {
       detached: true,

package/src/sqm/workflow-onboarding.js

@@ -0,0 +1,87 @@
+import { createInterface } from "node:readline/promises";
+
+import { inspectSqmAgentSkill, installSqmAgentSkill } from "./agent-skill.js";
+
+const INSTALL_FLAG = "--install-workflows";
+const SKIP_PROMPT_FLAG = "--no-workflow-prompt";
+
+export async function prepareDaemonWorkflows({
+  argv,
+  daemon,
+  daemonChild = process.env.SIMY_DAEMON_CHILD === "1",
+  stdinIsTTY = process.stdin.isTTY === true,
+  stdoutIsTTY = process.stdout.isTTY === true,
+  inspect = inspectSqmAgentSkill,
+  install = installSqmAgentSkill,
+  confirm = confirmWorkflowInstallation,
+  logger = console.log,
+  errorLogger = console.error,
+} = {}) {
+  if (!daemon || daemonChild) return { outcome: "not_applicable" };
+
+  const installRequested = argv.includes(INSTALL_FLAG);
+  const promptDisabled = argv.includes(SKIP_PROMPT_FLAG);
+  if (installRequested && promptDisabled) {
+    throw new Error(`${INSTALL_FLAG} cannot be combined with ${SKIP_PROMPT_FLAG}`);
+  }
+
+  let status;
+  try {
+    status = await inspect();
+  } catch (error) {
+    errorLogger(
+      `SIMY could not inspect the Codex/Claude workflows: ${message(error)}. The daemon will still start.`,
+    );
+    return { outcome: "inspection_failed", error };
+  }
+  if (status.installed) return { outcome: "already_installed", status };
+  if (promptDisabled) return { outcome: "skipped", status };
+
+  if (!installRequested && (!stdinIsTTY || !stdoutIsTTY)) {
+    logger(
+      "SIMY Codex/Claude workflows are missing or outdated. Re-run in a terminal with --install-workflows to install them.",
+    );
+    return { outcome: "confirmation_unavailable", status };
+  }
+
+  const accepted = installRequested || (await confirm({ status }));
+  if (!accepted) {
+    logger("SIMY workflow installation skipped. The daemon will still start.");
+    return { outcome: "declined", status };
+  }
+
+  try {
+    const installed = await install();
+    logger(
+      "SIMY workflows installed. Restart Codex, then install SIMY from Plugins > Personal before using @simy.",
+    );
+    return { outcome: "installed", status: installed };
+  } catch (error) {
+    errorLogger(`SIMY workflow installation failed: ${message(error)}. The daemon will still start.`);
+    return { outcome: "installation_failed", error, status };
+  }
+}
+
+export async function confirmWorkflowInstallation({
+  input = process.stdin,
+  output = process.stdout,
+} = {}) {
+  output.write(
+    [
+      "SIMY can install or update its Codex plugin marketplace, Codex/Claude SQM skills, and PR hooks.",
+      "Existing unrelated plugins and hooks will be preserved.",
+      "",
+    ].join("\n"),
+  );
+  const prompt = createInterface({ input, output });
+  try {
+    const answer = await prompt.question("Install SIMY workflows now? [y/N] ");
+    return /^(y|yes)$/i.test(answer.trim());
+  } finally {
+    prompt.close();
+  }
+}
+
+function message(error) {
+  return error instanceof Error ? error.message : String(error);
+}