@codions/portta 0.0.0-next.167.sha-e1101be → 0.0.0-next.173.sha-2bd7dd1

package/dist/assets/skills/portta-workflows/SKILL.md

@@ -251,7 +251,7 @@ Use `portta flow workflows validate <file>` before adding or changing a catalog
 
 ## Saved / named workflows
 
-Workflow IDs come from **`meta.name`**, not the filename. The durable Taskflow catalog resolves across three tiers, highest precedence first: **project** (`<project>/.portta/workflows/`), **global** (`~/.portta/state/host/workflows/`), and package **built-ins**. Place new workflows in Taskflow directories.
+Workflow IDs come from **`meta.name`**, not the filename. The durable Taskflow catalog resolves across three tiers, highest precedence first: **project** (`<project>/.portta/workflows/`), **global** (`~/portta/state/host/workflows/`), and package **built-ins**. Place new workflows in Taskflow directories.
 
 Six built-ins ship with Taskflow. Two are ports of Claude Code's bundled workflows:
 - **`deep-research`** — scope → 5 parallel web searches → fetch/dedup top sources → 3-vote adversarial verification per claim → cited report.

package/dist/assets/workflows/bake-off.workflow.js

@@ -1,8 +1,9 @@
-// Taskflow bake-off: both providers implement the same task in isolated fork leases, then
-// blind judges from both providers score the two diffs (neutral A/B labels, shuffled per run, so
-// neither judge knows whose work is whose), a tie-break settles splits, and the closing report
-// says what to graft from the loser. Both worktree branches are preserved for the user.
-// Run with: portta flow workflows run bake-off --args '"<task>"'   (or --args '{"task": "..."}')
+// Bake-off: both providers implement the same task in isolated fork leases, then blind judges
+// from both providers score the two diffs (neutral A/B labels, shuffled per run, so neither judge
+// knows whose work is whose), a tie-break settles splits, and the closing report says what to
+// graft from the loser. Both worktree branches are preserved for the user.
+// Run with: portta flow run workflow bake-off --input '<task>'
+//       or: portta flow workflows run bake-off --args '"<task>"'   (or --args '{"task": "..."}')
 
 export const meta = {
   name: "bake-off",

package/dist/assets/workflows/code-review.workflow.js

@@ -1,7 +1,7 @@
-// Port of Claude Code's built-in `code-review` workflow: one finder agent per review angle, an
-// independent verifier per candidate finding (CONFIRMED / PLAUSIBLE / REFUTED), a gap-sweep at
-// the higher levels, then a ranked, capped report.
-// Run with: portta flow workflows run code-review [--args '{"target": "<ref|path|diff>", "level": "high|xhigh|max"}']
+// Code review: one finder agent per review angle, an independent verifier per candidate finding
+// (CONFIRMED / PLAUSIBLE / REFUTED), a gap-sweep at the higher levels, then a ranked, capped report.
+// Run with: portta flow run workflow code-review [--input-json '{"target": "<ref|path|diff>", "level": "high|xhigh|max"}']
+//       or: portta flow workflows run code-review [--args '{"target": "<ref|path|diff>", "level": "high|xhigh|max"}']
 
 export const meta = {
   name: "code-review",

package/dist/assets/workflows/deep-research.workflow.js

@@ -1,6 +1,7 @@
-// Port of Claude Code's built-in `deep-research` workflow: fan out web searches, deep-read the
-// best sources, adversarially verify every claim with a 3-vote panel, synthesize a cited report.
-// Run with: portta flow workflows run deep-research --args '"<question>"'
+// Deep research: fan out web searches, deep-read the best sources, adversarially verify every
+// claim with a 3-vote panel, synthesize a cited report.
+// Run with: portta flow run workflow deep-research --input '<question>'
+//       or: portta flow workflows run deep-research --args '"<question>"'
 
 export const meta = {
   name: "deep-research",

package/dist/assets/workflows/multi-provider-review.workflow.js

@@ -1,7 +1,8 @@
-// taskflow-original built-in: the same change reviewed twice — once by Codex, once by Claude —
-// each over the ENTIRE feature/branch, then a synthesis pass merges both: consensus findings
-// (both providers saw it → highest confidence), unique catches, and disagreements called out.
-// Run with: portta flow workflows run multi-provider-review [--args '{"target": "<ref|path|diff>"}']
+// Multi-provider review: the same change reviewed twice — once by Codex, once by Claude — each
+// over the ENTIRE feature/branch, then a synthesis pass merges both: consensus findings (both
+// providers saw it → highest confidence), unique catches, and disagreements called out.
+// Run with: portta flow run workflow multi-provider-review [--input-json '{"target": "<ref|path|diff>"}']
+//       or: portta flow workflows run multi-provider-review [--args '{"target": "<ref|path|diff>"}']
 
 export const meta = {
   name: "multi-provider-review",

package/dist/assets/workflows/provider-debate.workflow.js

@@ -1,9 +1,10 @@
-// taskflow-original built-in: one provider proposes a position, the other attacks it, the
-// proposer rebuts or concedes, for N rounds — then a judge rules on what actually survived.
-// The cross-provider attacker is the point: a model is measurably worse at finding holes in its
-// own reasoning than another model is.
-// Run with: portta flow workflows run provider-debate --args '"<question>"'
-//       or: --args '{"question": "...", "rounds": 2, "proposer": "codex" | "claude-code"}'
+// Provider debate: one provider proposes a position, the other attacks it, the proposer rebuts
+// or concedes, for N rounds — then a judge rules on what actually survived. The cross-provider
+// attacker is the point: a model is measurably worse at finding holes in its own reasoning than
+// another model is.
+// Run with: portta flow run workflow provider-debate --input '<question>'
+//       or: portta flow workflows run provider-debate --args '"<question>"'
+//           (or --args '{"question": "...", "rounds": 2, "proposer": "codex" | "claude-code"}')
 
 export const meta = {
   name: "provider-debate",

package/dist/assets/workflows/second-opinion.workflow.js

@@ -1,8 +1,9 @@
-// taskflow-original built-in: ask both providers cheaply; if they agree, merge and return — if
-// they disagree, escalate both to deep effort with the other's answer in hand, then adjudicate.
+// Second opinion: ask both providers cheaply; if they agree, merge and return — if they
+// disagree, escalate both to deep effort with the other's answer in hand, then adjudicate.
 // Disagreement-triggered escalation: consensus-grade confidence at roughly half the cost of
 // always running the full panel.
-// Run with: portta flow workflows run second-opinion --args '"<question>"'
+// Run with: portta flow run workflow second-opinion --input '<question>'
+//       or: portta flow workflows run second-opinion --args '"<question>"'
 
 export const meta = {
   name: "second-opinion",