svamp-cli 0.2.180 → 0.2.181

package/dist/cli.mjs

@@ -375,11 +375,11 @@ async function main() {
     }), machineId);
     process.exit(0);
   } else if (subcommand === "issue" || subcommand === "issues") {
-    const { issueCommand } = await import('./commands-CBWOeFLL.mjs');
+    const { issueCommand } = await import('./commands-klb9OsmV.mjs');
     await issueCommand(args.slice(1));
     process.exit(0);
   } else if (subcommand === "workflow" || subcommand === "workflows") {
-    const { workflowCommand } = await import('./commands-CUSKCGUs.mjs');
+    const { workflowCommand } = await import('./commands-DUTReua3.mjs');
     await workflowCommand(args.slice(1));
     process.exit(0);
   } else if (subcommand === "wise-agent" || subcommand === "wise") {
@@ -394,7 +394,7 @@ async function main() {
   } else if (!subcommand || subcommand === "start") {
     await handleInteractiveCommand();
   } else if (subcommand === "--version" || subcommand === "-v") {
-    const pkg = await import('./package-4UtwIq9O.mjs').catch(() => ({ default: { version: "unknown" } }));
+    const pkg = await import('./package-D4USifdR.mjs').catch(() => ({ default: { version: "unknown" } }));
     console.log(`svamp version: ${pkg.default.version}`);
   } else {
     console.error(`Unknown command: ${subcommand}`);

package/dist/{commands-CUSKCGUs.mjs → commands-DUTReua3.mjs}

@@ -138,6 +138,20 @@ async function workflowCommand(args) {
       console.log(`\u2713 workflow "${wf.name}" completed.`);
       break;
     }
+    case "guide": {
+      console.log([
+        "CREATE an automation WORKFLOW from a request (GitHub-Actions-style, .svamp/workflows/<name>.yaml):",
+        "  svamp workflow add <kebab-name> \\",
+        '    [--on schedule --cron "<expr>" | --on dispatch | --on channel <name> | --on issue <labels>] \\',
+        '    --run "<shell/svamp command>" [--run "<cmd2>"]...',
+        "  - A step is any shell or svamp command. To start a self-verifying loop on a schedule:",
+        `      --run "svamp session loop <session-id> '<task>' --until '<done criteria>' [--max N]"`,
+        `  - To message/prompt a session: --run "svamp session send <id> '<text>'" (use the owner id, or "." in an owned workflow).`,
+        "  - Multiple --cron flags = multiple schedules. Pick a short kebab-case name.",
+        "  Then reply with a one-line summary of the workflow you created."
+      ].join("\n"));
+      break;
+    }
     case "help":
     case void 0:
     case "--help":
@@ -149,6 +163,7 @@ async function workflowCommand(args) {
         '             [--cron "0 9 * * 1-5"] [--channel <name>] [--issue ready,closed,labeled]',
         "  list | show <name> | remove <name>",
         "  run <name>   # execute the workflow's run-only steps now",
+        '  guide        # the "create a workflow from a request" procedure (so triggers can stay short)',
         "",
         "Each step is a shell command \u2014 every verb is a `svamp` CLI call, e.g.",
         '  svamp workflow add nightly --on schedule --cron "0 2 * * *" \\',

package/dist/{commands-CBWOeFLL.mjs → commands-klb9OsmV.mjs}

@@ -308,6 +308,43 @@ ${tail}
       for (const i of items) out(fmtIssue(i));
       break;
     }
+    case "guide": {
+      const topic = positional(rest)[0];
+      if (topic === "triage") {
+        out([
+          "TRIAGE an issue \u2014 turn a raw user post into a fully-specified, actionable issue:",
+          "  1. Read it:  svamp issue show <id>   (the user's original text is preserved separately)",
+          "  2. Triage it:",
+          '       svamp issue triage <id> --title "<concise title>" [--label <tag>]... \\',
+          `         [--inline | --crew] [--verify-cmd "<pass/fail cmd>" | --verify "<how we know it's done>"] \\`,
+          '         [--body "<expanded description>"]',
+          "     - inline = work it in this session; crew = isolated worktree child.",
+          "     - verify-cmd = a real pass/fail command (oracle); --verify = an agent/human criterion.",
+          "  3. SPLIT if the post bundles several independent asks: `svamp issue add` a new issue for",
+          "     each extra piece (carry over the relevant context) and triage each; keep the original as the primary.",
+          "  4. If it implies running on a schedule/event, also `svamp workflow add` it.",
+          "  Then reply with a one-line summary."
+        ].join("\n"));
+      } else if (topic === "work") {
+        out([
+          "WORK the ready issues in THIS session's backlog (your own + shared project items; leave other",
+          "sessions' private items alone). List: svamp issue list --status ready --session <id>.",
+          "  TRIAGE FIRST any \u25B3triage (untriaged) issue \u2014 see `svamp issue guide triage`.",
+          "  For each issue:",
+          "   1. On pickup: svamp issue work <id>   (status \u2192 in_progress; live status reflects the work).",
+          '   2. As you go: leave substantive `svamp issue comment <id> "\u2026"` notes \u2014 decisions, takeaways, blockers.',
+          "   3. Before closing: VERIFY with evidence \u2014 run its verify-cmd; for verify:agent cite the files/commit",
+          "      that resolve it in a summary comment. Post the summary, THEN `svamp issue close <id>`.",
+          "      NEVER close an issue that isn't genuinely resolved.",
+          "  CONVERGE TO MAIN: if an issue used an isolated branch/worktree, merge it back to `main` (and remove",
+          "  the worktree) BEFORE closing \u2014 never leave unmerged branches.",
+          "  Keep going until `svamp issue pending --session <id>` is empty."
+        ].join("\n"));
+      } else {
+        out("usage: svamp issue guide <triage|work>");
+      }
+      break;
+    }
     case "help":
     case void 0:
     case "--help":
@@ -317,14 +354,16 @@ ${tail}
         "",
         '  add ["<title>"] [--ready] [--label x] [--verify-cmd "cmd"] [--scope project|session] [--body "\u2026"]',
         "          # title optional \u2014 if omitted, the first line of --body becomes the title",
-        "  list [--status ready|backlog|in_progress|done|archived|all] [--label x] [--scope \u2026] [--json]",
+        "  list [--status ready|in_progress|archived|all] [--label x] [--scope \u2026] [--session <id>] [--json]",
         "  show <id> [--json]",
-        "  ready <id> | start <id> | close <id> | reopen <id> | backlog <id> | archive <id>",
+        "  ready <id> | close <id> (\u2192 archived) | reopen <id> | archive <id>   # lifecycle: ready \u2192 in_progress \u2192 archived",
         "  work <id> [--branch <name>]   # mark in-progress (optionally on a branch; merge to main before close)",
+        "  triage <id> [--title \u2026] [--label x] [--inline|--crew] [--verify-cmd \u2026|--verify \u2026] [--body \u2026]",
         "  edit <id> [--title \u2026] [--label x] [--verify-cmd \u2026] [--no-verify] [--status \u2026] [--body \u2026]",
         '  comment <id> "<text>"   # append a follow-up to the issue',
-        "  pending                 # exit 0 if no actionable issues: ready, in_progress, or untriaged backlog (loop oracle)",
-        '  search "<query>" [--json]'
+        "  pending [--session <id>]   # exit 0 if no actionable (ready/in_progress) issues \u2014 the loop oracle",
+        '  search "<query>" [--json]',
+        "  guide <triage|work>   # the triage / work-loop procedure (so triggers can stay short)"
       ].join("\n"));
       break;
     default:

package/dist/{package-4UtwIq9O.mjs → package-D4USifdR.mjs}

@@ -1,5 +1,5 @@
 var name = "svamp-cli";
-var version = "0.2.180";
+var version = "0.2.181";
 var description = "Svamp CLI — AI workspace daemon on Hypha Cloud";
 var author = "Amun AI AB";
 var license = "SEE LICENSE IN LICENSE";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svamp-cli",
-  "version": "0.2.180",
+  "version": "0.2.181",
   "description": "Svamp CLI — AI workspace daemon on Hypha Cloud",
   "author": "Amun AI AB",
   "license": "SEE LICENSE IN LICENSE",