@agimon-ai/po-workflow 0.0.0-alpha.0 → 0.0.0-stage

package/README.md

@@ -1,146 +1,3 @@
-# @agimon-ai/po-workflow
+# Temporary Holding Version
 
-Discover, launch, monitor, control, and recover asynchronous Po workflows.
-
-Part of the [Po distribution](https://www.npmjs.com/package/@agimon-ai/po).
-
-The integration embeds `@agimon-ai/workflow-mcp`. Workflow files describe job dependencies and
-host-executed steps, while Po provides session-scoped tools.
-
-> **Alpha:** workflow and recovery contracts may change between releases.
-
-## Requirements
-
-- Node.js 24 or newer
-
-## Install
-
-The seeded `modes.yaml` selects Workflow in `default.packages`. Keep it there or select it through
-a layer; its tools remain inactive until Workflow mode is enabled.
-
-## Define a workflow
-
-Create a `*.workflow.yml` file:
-
-```yaml
-name: verify
-
-jobs:
-  test:
-    steps:
-      - name: Run tests
-        run: pnpm test
-
-  summarize:
-    needs: test
-    steps:
-      - name: Record result
-        run: node scripts/write-verification-summary.mjs
-```
-
-`run` commands execute on the host with the workflow process's environment and privileges. There is
-no VM, container, or sandbox. Review workflow files as executable code. Runner-specific
-`interactiveRun` mappings are available for commands that require a TTY.
-
-A step can also declare `runConfig` (major mode, minor modes, profile, domains, model, thinking)
-and `customRun` (a prompt). Launched from the Po server, a `customRun` step runs as a child
-session of the launching session with those settings, until the agent has recorded what the step
-needs, and `run` and `interactiveRun` steps each get their own RMUX pane. Each run keeps its engine
-log in `engine.log` in its run directory. See `docs/automation.md` for the full contract and the
-CLI fallback.
-
-## Launch and monitor
-
-Core tools are:
-
-- `list_workflows`: discover workflows.
-- `launch_workflow`: register and start an asynchronous run.
-- `workflow_run`: inspect or control a run through supported actions.
-- `workflow_tools` (server/web sessions): read failed-run recovery evidence or resume the existing run.
-
-Launch returns after the run is registered, not after all jobs complete. Use status for progress
-and wait for a completion notification.
-
-## Storage, concurrency, and lifecycle
-
-Registry data defaults to `$HOME/.workflow-mcp`; set `WORKFLOW_MCP_HOME` to relocate it. Persisted
-records contain workflow and run identity, job and step state, ownership, output locations, and
-recovery evidence. The default concurrency ceiling is five runs.
-
-Runs launched through a terminal
-host such as tmux or cmux can have a different lifetime and remain manageable from the CLI. When
-Team is loaded, Workflow contributes active session runs through Team's `doom/background-work`
-service. That contribution reconnects after Team is replaced and is removed when Workflow unloads.
-Reconciliation distinguishes stale registry records from live processes; do not assume every run
-outlives its parent session.
-
-Each workflow or repair step can launch commands and model-backed agents, consuming provider quota
-and repeating external side effects.
-
-## Recovery
-
-Recovery is available only for records in a terminal failure state. A recovery claim atomically
-adopts the eligible failure, validates the evidence, and transfers ownership to the replay session.
-Live controls remain scoped to the owning session. Recovery does not launch a second copy beside a
-still-running job and does not guarantee that parent-session work survives shutdown.
-
-The package publishes `workflow-recovery`, `po-author-workflow` for writing workflow
-definitions, and `po-use-workflow` for launching, monitoring, and recovering runs while Workflow
-mode is active. Deactivating Workflow mode hides them; cached files may remain.
-
-## Workflow sessions
-
-In a server (web cockpit) session, a launch does not run in the session that asked for it. The
-session creates a child **workflow session** (provenance `workflow-session`), nested under it in the
-rail, and hands it the launch. The workflow session owns the run (`PI_SESSION_ID`), runs its step
-sessions, and has Workflow mode on, so its agent can troubleshoot and recover the run. The run's
-environment also carries `PO_WORKFLOW_LAUNCHER_SESSION_ID`, naming the launching session, which
-lists the run in its Activity group, is told when it ends, and may read its status.
-
-- The workflow session's rail row shows the run (`workflow · build › test · 4m`, or a failure or
-  pause marked like a pending question) through the host's per-session activity line.
-- Success is posted without starting a turn. Failure wakes the workflow owner for local diagnosis;
-  the launcher receives a notification only. The owner gets a live brief on every turn.
-- After a success, a workflow session nobody interacted with asks its launcher to release it, and it
-  becomes `stopped · open to wake`. A session whose run failed or paused, or whose agent you
-  prompted, stays live until you remove it. Removing or restarting a live workflow session stops its
-  run.
-- Recovery is refused from any session other than the owner while the owner is live.
-
-## Development
-
-```bash
-pnpm build
-pnpm typecheck
-pnpm test
-pnpm lint
-```
-
-Maintained by [Agimon](https://agimon.ai/about).
-
-## Web cockpit plugin
-
-The `.web` routed files under `src/extensions/workspaces/sessions/(frontend)` are this package's
-Po web cockpit plugin: the `workflow` dock face beside Activity and Context (the owned run's
-jobs, active steps and artifacts, each opening its own tab), the workflow catalog and launch
-dialog in the overlay slot, the Activity group's run rows (a handed-off run opens its workflow
-session), their stores, and the `workflow_runs` session channel, compiled into the cockpit bundle
-by `po-web`'s build. Each surface keeps its components in a colocated `_components` folder and
-its stores and helpers in `_lib`.
-The hub-side data source ships behind the `./web-hub` subpath and reads the workflow registry
-(run.json plus progress.ndjson) exactly as the engine writes it. Both halves are declared by the
-`poWeb` block in package.json.
-
-## License
-
-MIT, except this package's browser half (the `.web` routed files under `src/extensions` and the
-`_components` and `_lib` modules colocated with one), which is source available under the Po
-Web License (see `LICENSE.web`): free to use, including commercially, but not to redistribute.
-
-## Native execution contract
-
-Agent steps require an effective `runConfig.majorMode`; delegated workflows require top-level `runConfig.majorMode` before their owner child is created. Selection projects major mode, minor modes, profile and domains, adding the workflow minor mode once. `subagentModel` and `subagentThinking` set Team preferences independently of the step model.
-
-The native host requires execution-state inspection before creating agent steps. After settlement it waits for idle, no pending messages and a known background snapshot without core holds or holding-provider errors before checking decisions. Unknown ownership waits closed without consuming reminders; stops interrupt reads and retry delays.
-
-Delegated successes are informational. Errors wake the workflow owner through durable custom-message admission; the launcher gets an error notification, not an agent-waking failure completion. Diagnosis stays local. Recovery, pause, resume and stop are request-driven. User-requested stops do not trigger diagnosis or automatic restart.
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,133 +1,6 @@
 {
   "name": "@agimon-ai/po-workflow",
-  "version": "0.0.0-alpha.0",
-  "description": "GitHub Actions-style workflow graphs, artifacts, recovery, and asynchronous runs for Po.",
-  "keywords": [
-    "ai",
-    "automation",
-    "coding-agent",
-    "developer-tools",
-    "github-actions",
-    "pi-extension",
-    "pi-package",
-    "po",
-    "workflow",
-    "workflow-orchestration"
-  ],
-  "homepage": "https://agimon.ai",
-  "bugs": {
-    "url": "https://github.com/AgiFlow/po/issues"
-  },
-  "license": "MIT",
-  "author": "Vuong Ngo",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/AgiFlow/po.git",
-    "directory": "packages/minor/po-workflow"
-  },
-  "files": [
-    "dist",
-    "llms.txt",
-    "README.md",
-    "src/prompts",
-    "skills/workflow-recovery/SKILL.md",
-    "src/types/webWorkflows.ts",
-    "src/types/webWorkflowTerminal.ts"
-  ],
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "jsnext:main": "./dist/index.mjs",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.cjs"
-    },
-    "./extensions/server": {
-      "types": "./dist/extensions/server.d.mts",
-      "import": "./dist/extensions/server.mjs",
-      "require": "./dist/extensions/server.cjs"
-    },
-    "./extensions/web": {
-      "import": "./dist/extensions/web.mjs"
-    },
-    "./skills/workflow-recovery/SKILL.md": "./skills/workflow-recovery/SKILL.md",
-    "./package.json": "./package.json"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.0",
-    "@agimon-ai/po-minor-mode": "0.0.0-alpha.0",
-    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
-    "@agimon-ai/po-ui": "0.0.0-alpha.0",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.0",
-    "@agimon-ai/po-web-security": "0.0.0-alpha.0",
-    "@agimon-ai/workflow-mcp": "0.24.12",
-    "@deepseek-ai/cordis": "4.0.4",
-    "@modelcontextprotocol/server": "2.2.0",
-    "hono": "4.13.12",
-    "typebox": "1.3.34",
-    "zod": "4.6.5"
-  },
-  "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.0",
-    "@earendil-works/pi-coding-agent": "1.0.2",
-    "@tanstack/react-store": "0.11.2",
-    "@tanstack/store": "0.11.2",
-    "@types/node": "26.6.4",
-    "@types/react": "19.3.0",
-    "@types/react-dom": "19.3.0",
-    "@vitest/coverage-v8": "5.0.3",
-    "react": "19.3.0",
-    "react-dom": "19.3.0",
-    "tsdown": "0.23.0",
-    "typescript": "7.0.2",
-    "vitest": "5.0.3"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "1.0.2"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "poServer": {
-    "entry": "./generated/server.ts",
-    "dist": "./dist/extensions/server.mjs",
-    "scopes": [
-      "global",
-      "workspace",
-      "session"
-    ],
-    "contracts": {
-      "entry": "./src/exports/apiContracts.ts",
-      "dist": "./dist/apiContracts.mjs"
-    }
-  },
-  "poWeb": {
-    "pluginId": "workflows",
-    "channels": [
-      "workflow_catalog",
-      "workflow_runs"
-    ],
-    "client": "./dist/extensions/web.mjs",
-    "scopes": [
-      "session"
-    ]
-  },
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest --run",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
-    "lint": "oxlint . && oxfmt . --check",
-    "fixcode": "oxlint . --fix && oxfmt ."
-  }
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
 }

package/LICENSE

@@ -1,29 +0,0 @@
-Portions of this software are licensed as follows:
-
-* The browser half of this package, meaning every ".web" routed file under
-  "src/extensions" and the "_components" and "_lib" modules colocated with
-  one, is licensed under the Po Web License defined in "LICENSE.web":
-  free to use, not to redistribute.
-* All other content is licensed under the MIT license below.
-
-MIT License
-
-Copyright (c) 2026 Vuong Ngo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/LICENSE.web

@@ -1,29 +0,0 @@
-The Po Web License
-
-Copyright (c) 2026 Agimon Pty Ltd
-
-With regard to the Po Web Software:
-
-This software and associated documentation files (the "Software") may be
-used, free of charge, by any person or entity, for any purpose, including
-production and commercial use. You may copy the Software as reasonably
-necessary to install, run, develop against, test, and back it up. You are
-free to modify the Software for your own use and to publish patches to the
-Software. You agree that the licensor retains all right, title, and interest
-in and to the Software, and that your modifications and patches may only be
-used, copied, modified, displayed, distributed, or otherwise exploited
-together with the Software. You are not granted any other rights beyond what
-is expressly stated herein. Subject to the foregoing, it is forbidden to
-publish, distribute, sublicense, and/or sell the Software or any copy of it,
-or to offer the Software to third parties as a hosted or managed service.
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-IN THE SOFTWARE.