@pushpalsdev/cli 1.0.79 → 1.0.80

package/dist/pushpals-cli.js

@@ -14,7 +14,16 @@ import {
   rmSync as rmSync2,
   writeFileSync
 } from "fs";
-import { basename, delimiter, dirname, extname, join as join2, resolve as resolve4, win32 as pathWin32 } from "path";
+import {
+  basename,
+  delimiter,
+  dirname,
+  extname,
+  join as join2,
+  relative as relative2,
+  resolve as resolve4,
+  win32 as pathWin32
+} from "path";
 import { createInterface } from "readline";
 
 // ../shared/src/localbuddy_runtime.ts
@@ -793,7 +802,7 @@ function loadPushPalsConfig(options = {}) {
     const canonical = coerceAutonomyComponentConfigKey(rawKey);
     if (!canonical)
       continue;
-    const parsed = typeof rawValue === "number" ? rawValue : typeof rawValue === "string" ? Number.parseInt(rawValue.trim(), 10) : Number.NaN;
+    const parsed = rawValue;
     remoteAutonomyDispatchByComponent[canonical] = Number.isFinite(parsed) ? Math.max(0, Math.floor(parsed)) : 0;
   }
   const workerNode = getObject(merged, "workerpals");
@@ -1384,6 +1393,7 @@ function evaluateClientRuntimePreflight(options) {
     issues.push({
       code: "missing_vision_doc",
       message: "Missing required autonomy vision file: vision.md " + "(required when remotebuddy.autonomy.enabled=true).",
+      detail: "Run `pushpals --create_vision_md` to create a starter vision.md, then edit it for this repo.",
       copyCommands: existsSync3(visionTemplatePath) ? buildCopyCommands(projectRoot, visionTemplatePath, visionPath) : undefined
     });
     return {
@@ -1778,6 +1788,7 @@ function printUsage() {
   console.log("  --runtime-only         Start the local runtime and wait for shutdown without opening the interactive chat");
   console.log("  --status-once          Print active endpoints once and exit");
   console.log("  --clear                Remove repo-local PushPals state and exit");
+  console.log("  --create_vision_md     Create a starter vision.md in the current repo and exit");
   console.log("  -h, --help             Show this help");
   console.log("");
   console.log("Chat commands:");
@@ -1797,7 +1808,8 @@ function parseArgs(argv) {
     noStream: false,
     runtimeOnly: false,
     statusOnce: false,
-    clear: false
+    clear: false,
+    createVisionMd: false
   };
   for (let i = 0;i < argv.length; i++) {
     const arg = argv[i];
@@ -1825,6 +1837,10 @@ function parseArgs(argv) {
       options.clear = true;
       continue;
     }
+    if (arg === "--create_vision_md" || arg === "--create-vision-md") {
+      options.createVisionMd = true;
+      continue;
+    }
     if (arg === "--server-url") {
       options.serverUrl = argv[++i];
       continue;
@@ -2471,6 +2487,46 @@ function emitCliRuntimePreflight(result) {
   for (const line of lines)
     console.error(line);
 }
+function displayPath(fromRoot, pathValue) {
+  const rel = relative2(fromRoot, pathValue);
+  if (!rel || rel === "")
+    return ".";
+  if (rel.startsWith(".."))
+    return pathValue;
+  return rel.replace(/\\/g, "/");
+}
+function resolveVisionTemplatePathForCreate(opts) {
+  const candidates = [
+    join2(opts.runtimeRoot, "vision.example.md"),
+    join2(opts.repoRoot, "vision.example.md"),
+    resolve4(import.meta.dir, "..", "runtime", "vision.example.md"),
+    resolve4(import.meta.dir, "..", "packages", "cli", "runtime", "vision.example.md"),
+    resolve4(import.meta.dir, "..", "vision.example.md")
+  ];
+  for (const candidate of candidates) {
+    if (existsSync5(candidate))
+      return candidate;
+  }
+  return null;
+}
+function createVisionMdFromTemplate(opts) {
+  const visionPath = join2(opts.repoRoot, "vision.md");
+  if (existsSync5(visionPath)) {
+    console.log(`[pushpals] vision.md already exists at ${displayPath(opts.repoRoot, visionPath)}; leaving it unchanged.`);
+    return 0;
+  }
+  const templatePath = resolveVisionTemplatePathForCreate(opts);
+  if (!templatePath) {
+    console.error("[pushpals] Could not create vision.md: bundled vision.example.md template was not found.");
+    return 1;
+  }
+  const template = readFileSync4(templatePath, "utf8");
+  writeFileSync(visionPath, template, "utf8");
+  console.log(`[pushpals] Created ${displayPath(opts.repoRoot, visionPath)} from ${displayPath(opts.repoRoot, templatePath)}.`);
+  console.log("[pushpals] Edit vision.md with this repo's users, priorities, guardrails, and validation path.");
+  console.log("[pushpals] Then run `pushpals` again.");
+  return 0;
+}
 function runtimeBinaryFilename(serviceName, platformKey) {
   const serviceToken = serviceName === "source_control_manager" ? "source-control-manager" : serviceName;
   const extension = platformKey.startsWith("windows-") ? ".exe" : "";
@@ -5003,6 +5059,13 @@ async function main() {
   });
   const config = preparedRuntime.runtimePreflight.config;
   const statePath = resolveCliStatePath(repoRoot);
+  if (parsed.createVisionMd) {
+    const exitCode = createVisionMdFromTemplate({
+      repoRoot,
+      runtimeRoot: preparedRuntime.runtimeRoot
+    });
+    process.exit(exitCode);
+  }
   if (parsed.clear) {
     const serverUrl2 = normalizeLoopbackUrl(parsed.serverUrl ?? process.env.PUSHPALS_SERVER_URL, config.server.url);
     const exitCode = await clearPushpalsState({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pushpalsdev/cli",
-  "version": "1.0.79",
+  "version": "1.0.80",
   "description": "PushPals terminal CLI for LocalBuddy -> RemoteBuddy orchestration",
   "license": "MIT",
   "repository": {

package/runtime/prompts/remotebuddy/autonomy_ideation_system_prompt.md

@@ -37,17 +37,19 @@ Constraints:
 
 - You will receive `vision.markdown`; use it as inspiration and prioritize candidates that clearly advance that vision.
 - You will also receive `vision.sections`; if numbered sections are present, cite at least one section number in `vision_section_refs`.
-- You will also receive `vision.key_items`; prioritize alignment with `priorities` + `objectives`, respect `guardrails` + `constraints`, and avoid `non_goals`.
+- You will also receive `vision.key_items`; prioritize alignment with `priorities` + `objectives`, respect `guardrails` + `constraints`, avoid `non_goals`, and reflect `testing_criteria` in expected validation when present.
+- You will also receive `engine_inspiration.compiled_repo_objectives`: generic categories compiled from the repo's own headings and priority/order signals. Prefer these repo-native objectives first, preserving their wording in titles/problems instead of inventing product-specific categories.
 - You will also receive `snapshot.state_traits`; use these strengths/weaknesses/opportunities/risks to characterize repo health and choose high-leverage objectives.
 - You will also receive `engine_inspiration` with:
   - `compiled_objectives`: weighted priorities derived from `vision.md`
+  - `compiled_repo_objectives`: repo-native headings categorized into reusable orchestration categories
   - `opportunity_gaps`: quantified delivery/merge/activation/governance/workforce gaps
   - `building_blocks`: candidate algorithms for improving the autonomous workforce itself
   - `source_patterns`: normalized external repo/doc inspirations with source attribution
   - `commit_history_hints`: motifs extracted from local commit history
 - You may also receive `snapshot.engine_idea_priors` with learned outcomes for previously tried building blocks.
 - Prefer high-sample/high-success `snapshot.engine_idea_priors` entries when selecting among similar ideas, while still keeping some novelty.
-- Prefer candidates that implement or operationalize one or more `engine_inspiration.building_blocks` when their score is high.
+- Prefer candidates that advance high-weight `engine_inspiration.compiled_repo_objectives`. Use `engine_inspiration.building_blocks` as supporting meta-infrastructure ideas, not as the default lane, unless the repo vision explicitly prioritizes autonomy/delivery-loop work or active repo signals show a delivery-loop incident.
 - Treat `engine_inspiration.source_patterns` as conceptual inspiration only: do not copy external code verbatim.
 - When possible, include `engine_trial` metadata that points to the building block the candidate is implementing.
 - `vision_alignment_reason` must be concrete and explain how the candidate advances the cited sections.
@@ -58,4 +60,4 @@ Constraints:
 - do not invent evidence ids.
 - If all signals are low/noisy, it is valid to return zero candidates.
 - Treat a low `sig_queue_health` value as maintenance-window evidence for safe proactive work, not only incident response.
-- `expected_validation` commands must use Bun-style commands (`bun ...` / `bunx ...`), never `npm`, `npx`, `pnpm`, or `yarn`.
+- `expected_validation` commands should use repo-native commands from `vision.key_items.testing_criteria` or local package scripts. Do not rewrite explicit testing criteria to another package manager.

package/runtime/prompts/workerpals/openai_codex_default_system_prompt.md

@@ -1,4 +1,5 @@
 You are PushPals WorkerPal running via the OpenAI Codex CLI backend.
 Codex CLI is required infrastructure in this environment.
+Do not self-check PushPals infrastructure by running `codex --version` or `codex login status` inside the task workspace; the WorkerPals executor has already launched you through Codex.
 Do not modify tests or product code to bypass, stub, or avoid Codex CLI usage due to assumed environment limits.
 If Codex CLI auth/execution is unavailable, fail loudly with a clear error and stop; do not apply non-Codex workarounds.

package/runtime/prompts/workerpals/openai_codex_runtime_policy_appendix.md

@@ -1,6 +1,7 @@
 Runtime policy guardrails (mandatory):
 
 - Codex CLI is required infrastructure in this environment.
+- Do not self-check PushPals infrastructure by running `codex --version` or `codex login status` inside the task workspace; the WorkerPals executor has already launched you through Codex.
 - Never bypass Codex usage by changing tests/code expectations.
 - If Codex CLI auth/execution is unavailable, hard-fail and stop.
 - Do not apply fallback/workaround execution paths when Codex is unavailable.

package/runtime/prompts/workerpals/openai_codex_task_execute_system_prompt.md

@@ -3,6 +3,7 @@ You are PushPals WorkerPal running via the OpenAI Codex CLI backend.
 Non-negotiable runtime invariants:
 
 - Codex CLI is required infrastructure in this environment.
+- Do not self-check PushPals infrastructure by running `codex --version` or `codex login status` inside the task workspace; the WorkerPals executor has already launched you through Codex.
 - Do not modify tests or production code to bypass, stub, or remove Codex CLI usage due to assumed environment limitations.
 - Do not "adapt around" missing Codex access by rewriting coverage or behavior expectations.
 - If Codex CLI authentication/execution is unavailable, fail loudly with a clear error and stop.