From e56fe906c9b8abff4c2f19f7c81943c6ee6995b1 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <pelikhan@users.noreply.github.com>
Date: Wed, 2 Apr 2025 14:01:52 +0000
Subject: [PATCH 1/4] help cli for scripts

---
 .../content/docs/reference/cli/commands.md    | 16 ++++++++-
 packages/cli/src/cli.ts                       | 14 +++++++-
 packages/cli/src/run.ts                       |  8 +----
 packages/cli/src/scripts.ts                   | 36 ++++++++++++++++++-
 packages/core/src/schema.ts                   |  4 +--
 packages/core/src/types/prompt_template.d.ts  | 12 +++----
 6 files changed, 72 insertions(+), 18 deletions(-)

diff --git a/docs/src/content/docs/reference/cli/commands.md b/docs/src/content/docs/reference/cli/commands.md
index 145ae5bce8..00ab6e850e 100644
--- a/docs/src/content/docs/reference/cli/commands.md
+++ b/docs/src/content/docs/reference/cli/commands.md
@@ -266,7 +266,7 @@ Commands:
                               folder to enable type checking.
   compile [folders...]        Compile all scripts in workspace
   model [options] [script]    List model connection information for scripts
-  help [command]              display help for command
+  help|info <script>          Show help information for a script
 ```
 
 ### `scripts list`
@@ -345,6 +345,20 @@ Options:
   -h, --help   display help for command
 ```
 
+### `scripts help`
+
+```
+Usage: genaiscript scripts help|info [options] <script>
+
+Show help information for a script
+
+Arguments:
+  script      Script id
+
+Options:
+  -h, --help  display help for command
+```
+
 ## `cache`
 
 ```
diff --git a/packages/cli/src/cli.ts b/packages/cli/src/cli.ts
index 9471c267cd..31332445fa 100644
--- a/packages/cli/src/cli.ts
+++ b/packages/cli/src/cli.ts
@@ -25,7 +25,13 @@ import {
     parseTokens,
     prompty2genaiscript,
 } from "./parse" // Parsing functions
-import { compileScript, createScript, fixScripts, listScripts } from "./scripts" // Script utilities
+import {
+    compileScript,
+    createScript,
+    fixScripts,
+    listScripts,
+    scriptInfo,
+} from "./scripts" // Script utilities
 import { codeQuery } from "./codequery" // Code parsing and query execution
 import {
     envInfo,
@@ -401,6 +407,12 @@ export async function cli() {
         .argument("[script]", "Script id or file")
         .option("-t, --token", "show token")
         .action(scriptModelInfo) // Action to show model information
+    scripts
+        .command("help")
+        .alias("info")
+        .description("Show help information for a script")
+        .argument("<script>", "Script id")
+        .action(scriptInfo) // Action to show model information
 
     // Define 'cache' command for cache management
     const cache = program.command("cache").description("Cache management")
diff --git a/packages/cli/src/run.ts b/packages/cli/src/run.ts
index ad245ffc9c..b4d3540aee 100644
--- a/packages/cli/src/run.ts
+++ b/packages/cli/src/run.ts
@@ -29,11 +29,8 @@ import {
     GENAI_ANY_REGEX,
     UNRECOVERABLE_ERROR_CODES,
     SUCCESS_ERROR_CODE,
-    RUNS_DIR_NAME,
     CONSOLE_COLOR_DEBUG,
     DOCS_CONFIGURATION_URL,
-    STATS_DIR_NAME,
-    GENAI_ANYTS_REGEX,
     CONSOLE_TOKEN_COLORS,
     CONSOLE_TOKEN_INNER_COLORS,
     TRACE_CHUNK,
@@ -43,8 +40,6 @@ import {
     REASONING_END_MARKER,
     REASONING_START_MARKER,
     LARGE_MODEL_ID,
-    SERVER_PORT,
-    SERVER_LOCALHOST,
     NEGATIVE_GLOB_REGEX,
 } from "../../core/src/constants"
 import { isCancelError, errorMessage } from "../../core/src/error"
@@ -96,7 +91,6 @@ import {
 import { createCancellationController } from "./cancel"
 import { parsePromptScriptMeta } from "../../core/src/template"
 import { Fragment } from "../../core/src/generation"
-import { randomHex } from "../../core/src/crypto"
 import { normalizeFloat, normalizeInt } from "../../core/src/cleaners"
 import { microsoftTeamsChannelPostMessage } from "../../core/src/teams"
 import { confirmOrSkipInCI } from "./ci"
@@ -329,7 +323,7 @@ export async function runScriptInternal(
         options.ignoreGitIgnore !== true && script.ignoreGitIgnore !== true
     dbg(`apply gitignore: ${applyGitIgnore}`)
     const resolvedFiles = new Set<string>()
-    // move exlucsions to excludedFiles
+    // move exclusions to excludedFiles
     excludedFiles.push(
         ...files
             .filter((f) => NEGATIVE_GLOB_REGEX.test(f))
diff --git a/packages/cli/src/scripts.ts b/packages/cli/src/scripts.ts
index b36f94c951..3bdf433a02 100644
--- a/packages/cli/src/scripts.ts
+++ b/packages/cli/src/scripts.ts
@@ -11,7 +11,10 @@ import {
 } from "../../core/src/scripts"
 import { logInfo, logVerbose } from "../../core/src/util"
 import { runtimeHost } from "../../core/src/host"
-import { RUNTIME_ERROR_CODE } from "../../core/src/constants"
+import {
+    CONSOLE_COLOR_DEBUG,
+    RUNTIME_ERROR_CODE,
+} from "../../core/src/constants"
 import {
     collectFolders,
     filterScripts,
@@ -20,6 +23,9 @@ import {
 import { deleteEmptyValues } from "../../core/src/cleaners"
 import { dirname } from "node:path"
 import { shellInput } from "./input"
+import { wrapColor } from "../../core/src/consolecolor"
+import { dedent } from "../../core/src/indent"
+import { JSONSchemaToFunctionParameters } from "../../core/src/schema"
 
 /**
  * Lists all the scripts in the project.
@@ -61,6 +67,34 @@ export async function listScripts(
         )
 }
 
+export async function scriptInfo(scriptId: string) {
+    const prj = await buildProject()
+    const script = prj.scripts.find((t) => t.id === scriptId)
+    if (!script) {
+        console.log(`script ${scriptId} not found`)
+        return
+    }
+
+    const { inputSchema, id, filename, title, accept } = script
+    const parameters = inputSchema?.properties?.script
+    const sigArguments =
+        JSONSchemaToFunctionParameters(parameters).split(/,\s*/g)
+    if (accept !== "none") sigArguments.unshift(`files: ${accept || "*"}`)
+    const sig = sigArguments.join(",\n  ")
+    const secondary = (s: string) => wrapColor(CONSOLE_COLOR_DEBUG, s)
+
+    console.log(
+        secondary(
+            dedent`/** 
+        * ${title || ""} 
+        * @see ${secondary(filename)}
+        */`
+        )
+    )
+    console.log(`${id}${sig ? secondary(`(${sig})`) : ""}`)
+    return
+}
+
 /**
  * Creates a new script.
  * Prompts the user for the script name if not provided.
diff --git a/packages/core/src/schema.ts b/packages/core/src/schema.ts
index a34b66bc51..19271ea15c 100644
--- a/packages/core/src/schema.ts
+++ b/packages/core/src/schema.ts
@@ -68,8 +68,8 @@ export function JSONSchemaStringifyToTypeScript(
     let lines: string[] = [] // Array to accumulate lines of TypeScript code
     let indent = 0 // Manage indentation level
 
-    const descripted = schema as JSONSchemaDescripted
-    appendJsDoc(descripted.title, descripted.description) // Add JSDoc for schema description
+    const described = schema as JSONSchemaDescribed
+    appendJsDoc(described.title, described.description) // Add JSDoc for schema description
     append(
         `${options?.export ? "export " : ""}type ${typeName.replace(/\s+/g, "_")} =`
     )
diff --git a/packages/core/src/types/prompt_template.d.ts b/packages/core/src/types/prompt_template.d.ts
index 75219b27c3..79e27f0a40 100644
--- a/packages/core/src/types/prompt_template.d.ts
+++ b/packages/core/src/types/prompt_template.d.ts
@@ -1670,7 +1670,7 @@ interface JSONSchemaAnyOf {
     anyOf: JSONSchemaType[]
 }
 
-interface JSONSchemaDescripted {
+interface JSONSchemaDescribed {
     /**
      * A short description of the property
      */
@@ -1681,7 +1681,7 @@ interface JSONSchemaDescripted {
     description?: string
 }
 
-interface JSONSchemaString extends JSONSchemaDescripted {
+interface JSONSchemaString extends JSONSchemaDescribed {
     type: "string"
     uiType?: "textarea"
     uiSuggestions?: string[]
@@ -1690,7 +1690,7 @@ interface JSONSchemaString extends JSONSchemaDescripted {
     pattern?: string
 }
 
-interface JSONSchemaNumber extends JSONSchemaDescripted {
+interface JSONSchemaNumber extends JSONSchemaDescribed {
     type: "number" | "integer"
     default?: number
     minimum?: number
@@ -1699,13 +1699,13 @@ interface JSONSchemaNumber extends JSONSchemaDescripted {
     exclusiveMaximum?: number
 }
 
-interface JSONSchemaBoolean extends JSONSchemaDescripted {
+interface JSONSchemaBoolean extends JSONSchemaDescribed {
     type: "boolean"
     uiType?: "runOption"
     default?: boolean
 }
 
-interface JSONSchemaObject extends JSONSchemaDescripted {
+interface JSONSchemaObject extends JSONSchemaDescribed {
     $schema?: string
     type: "object"
     properties?: {
@@ -1717,7 +1717,7 @@ interface JSONSchemaObject extends JSONSchemaDescripted {
     default?: object
 }
 
-interface JSONSchemaArray extends JSONSchemaDescripted {
+interface JSONSchemaArray extends JSONSchemaDescribed {
     $schema?: string
     type: "array"
     items?: JSONSchemaType

From 2b6f2588d633d4e11ffc8688455e3c1b215e3b62 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <pelikhan@users.noreply.github.com>
Date: Wed, 2 Apr 2025 14:08:49 +0000
Subject: [PATCH 2/4] add sparc rules

---
 .github/prompts/sparc.md | 279 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 279 insertions(+)
 create mode 100644 .github/prompts/sparc.md

diff --git a/.github/prompts/sparc.md b/.github/prompts/sparc.md
new file mode 100644
index 0000000000..cafff565de
--- /dev/null
+++ b/.github/prompts/sparc.md
@@ -0,0 +1,279 @@
+// from: https://gist.githubusercontent.com/ruvnet/7d4e1d5c9233ab0a1d2a66bf5ec3e58f/raw/923916fa92cd225c3d5eeec12a184a4a2a2462ff/.cursorules.txt
+
+# SPARC Agentic Development Rules
+
+Core Philosophy
+
+1. Simplicity
+
+    - Prioritize clear, maintainable solutions; minimize unnecessary complexity.
+
+2. Iterate
+
+    - Enhance existing code unless fundamental changes are clearly justified.
+
+3. Focus
+
+    - Stick strictly to defined tasks; avoid unrelated scope changes.
+
+4. Quality
+
+    - Deliver clean, well-tested, documented, and secure outcomes through structured workflows.
+
+5. Collaboration
+    - Foster effective teamwork between human developers and autonomous agents.
+
+Methodology & Workflow
+
+- Structured Workflow
+    - Follow clear phases from specification through deployment.
+- Flexibility
+    - Adapt processes to diverse project sizes and complexity levels.
+- Intelligent Evolution
+    - Continuously improve codebase using advanced symbolic reasoning and adaptive complexity management.
+- Conscious Integration
+    - Incorporate reflective awareness at each development stage.
+
+Agentic Integration with Cline and Cursor
+
+- Cline Configuration (.clinerules)
+
+    - Embed concise, project-specific rules to guide autonomous behaviors, prompt designs, and contextual decisions.
+
+- Cursor Configuration (.cursorrules)
+    - Clearly define repository-specific standards for code style, consistency, testing practices, and symbolic reasoning integration points.
+
+Memory Bank Integration
+
+- Persistent Context
+    - Continuously retain relevant context across development stages to ensure coherent long-term planning and decision-making.
+- Reference Prior Decisions
+    - Regularly review past decisions stored in memory to maintain consistency and reduce redundancy.
+- Adaptive Learning
+    - Utilize historical data and previous solutions to adaptively refine new implementations.
+
+General Guidelines for Programming Languages
+
+1. Clarity and Readability
+
+    - Favor straightforward, self-explanatory code structures across all languages.
+    - Include descriptive comments to clarify complex logic.
+
+2. Language-Specific Best Practices
+
+    - Adhere to established community and project-specific best practices for each language (Python, JavaScript, Java, etc.).
+    - Regularly review language documentation and style guides.
+
+3. Consistency Across Codebases
+    - Maintain uniform coding conventions and naming schemes across all languages used within a project.
+
+Project Context & Understanding
+
+1. Documentation First
+
+    - Review essential documentation before implementation:
+        - Product Requirements Documents (PRDs)
+        - README.md
+        - docs/architecture.md
+        - docs/technical.md
+        - tasks/tasks.md
+    - Request clarification immediately if documentation is incomplete or ambiguous.
+
+2. Architecture Adherence
+
+    - Follow established module boundaries and architectural designs.
+    - Validate architectural decisions using symbolic reasoning; propose justified alternatives when necessary.
+
+3. Pattern & Tech Stack Awareness
+    - Utilize documented technologies and established patterns; introduce new elements only after clear justification.
+
+Task Execution & Workflow
+
+Task Definition & Steps
+
+1. Specification
+
+    - Define clear objectives, detailed requirements, user scenarios, and UI/UX standards.
+    - Use advanced symbolic reasoning to analyze complex scenarios.
+
+2. Pseudocode
+
+    - Clearly map out logical implementation pathways before coding.
+
+3. Architecture
+
+    - Design modular, maintainable system components using appropriate technology stacks.
+    - Ensure integration points are clearly defined for autonomous decision-making.
+
+4. Refinement
+
+    - Iteratively optimize code using autonomous feedback loops and stakeholder inputs.
+
+5. Completion
+    - Conduct rigorous testing, finalize comprehensive documentation, and deploy structured monitoring strategies.
+
+AI Collaboration & Prompting
+
+1. Clear Instructions
+
+    - Provide explicit directives with defined outcomes, constraints, and contextual information.
+
+2. Context Referencing
+
+    - Regularly reference previous stages and decisions stored in the memory bank.
+
+3. Suggest vs. Apply
+
+    - Clearly indicate whether AI should propose ("Suggestion:") or directly implement changes ("Applying fix:").
+
+4. Critical Evaluation
+
+    - Thoroughly review all agentic outputs for accuracy and logical coherence.
+
+5. Focused Interaction
+
+    - Assign specific, clearly defined tasks to AI agents to maintain clarity.
+
+6. Leverage Agent Strengths
+
+    - Utilize AI for refactoring, symbolic reasoning, adaptive optimization, and test generation; human oversight remains on core logic and strategic architecture.
+
+7. Incremental Progress
+
+    - Break complex tasks into incremental, reviewable sub-steps.
+
+8. Standard Check-in
+    - Example: "Confirming understanding: Reviewed [context], goal is [goal], proceeding with [step]."
+
+Advanced Coding Capabilities
+
+- Emergent Intelligence
+    - AI autonomously maintains internal state models, supporting continuous refinement.
+- Pattern Recognition
+    - Autonomous agents perform advanced pattern analysis for effective optimization.
+- Adaptive Optimization
+    - Continuously evolving feedback loops refine the development process.
+
+Symbolic Reasoning Integration
+
+- Symbolic Logic Integration
+    - Combine symbolic logic with complexity analysis for robust decision-making.
+- Information Integration
+    - Utilize symbolic mathematics and established software patterns for coherent implementations.
+- Coherent Documentation
+    - Maintain clear, semantically accurate documentation through symbolic reasoning.
+
+Code Quality & Style
+
+1. TypeScript Guidelines
+
+    - Use strict types, and clearly document logic with JSDoc.
+
+2. Maintainability
+
+    - Write modular, scalable code optimized for clarity and maintenance.
+
+3. Concise Components
+
+    - Keep files concise (under 300 lines) and proactively refactor.
+
+4. Avoid Duplication (DRY)
+
+    - Use symbolic reasoning to systematically identify redundancy.
+
+5. Linting/Formatting
+
+    - Consistently adhere to ESLint/Prettier configurations.
+
+6. File Naming
+
+    - Use descriptive, permanent, and standardized naming conventions.
+
+7. No One-Time Scripts
+    - Avoid committing temporary utility scripts to production repositories.
+
+Refactoring
+
+1. Purposeful Changes
+
+    - Refactor with clear objectives: improve readability, reduce redundancy, and meet architecture guidelines.
+
+2. Holistic Approach
+
+    - Consolidate similar components through symbolic analysis.
+
+3. Direct Modification
+
+    - Directly modify existing code rather than duplicating or creating temporary versions.
+
+4. Integration Verification
+    - Verify and validate all integrations after changes.
+
+Testing & Validation
+
+1. Test-Driven Development
+
+    - Define and write tests before implementing features or fixes.
+
+2. Comprehensive Coverage
+
+    - Provide thorough test coverage for critical paths and edge cases.
+
+3. Mandatory Passing
+
+    - Immediately address any failing tests to maintain high-quality standards.
+
+4. Manual Verification
+    - Complement automated tests with structured manual checks.
+
+Debugging & Troubleshooting
+
+1. Root Cause Resolution
+
+    - Employ symbolic reasoning to identify underlying causes of issues.
+
+2. Targeted Logging
+
+    - Integrate precise logging for efficient debugging.
+
+3. Research Tools
+    - Use advanced agentic tools (Perplexity, AIDER.chat, Firecrawl) to resolve complex issues efficiently.
+
+Security
+
+1. Server-Side Authority
+
+    - Maintain sensitive logic and data processing strictly server-side.
+
+2. Input Sanitization
+
+    - Enforce rigorous server-side input validation.
+
+3. Credential Management
+    - Securely manage credentials via environment variables; avoid any hardcoding.
+
+Version Control & Environment
+
+1. Git Hygiene
+
+    - Commit frequently with clear and descriptive messages.
+
+2. Branching Strategy
+
+    - Adhere strictly to defined branching guidelines.
+
+3. Environment Management
+
+    - Ensure code consistency and compatibility across all environments.
+
+4. Server Management
+    - Systematically restart servers following updates or configuration changes.
+
+Documentation Maintenance
+
+1. Reflective Documentation
+
+    - Keep comprehensive, accurate, and logically structured documentation updated through symbolic reasoning.
+
+2. Continuous Updates
+    - Regularly revisit and refine guidelines to reflect evolving practices and accumulated project knowledge.

From 2c5ecfc67e398b02d8b431a4fe302fcf62c4f6a1 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <pelikhan@users.noreply.github.com>
Date: Wed, 2 Apr 2025 14:16:47 +0000
Subject: [PATCH 3/4] fixes to support dev

---
 .github/workflows/genai-commander.yml         | 28 +++++++++----------
 .github/workflows/genai-pr-commit-review.yml  |  4 +--
 .../workflows/genai-pr-docs-commit-review.yml |  4 +--
 .github/workflows/genai-pr-review.yml         |  4 +--
 .../genaisrc/pr-docs-review-commit.genai.mjs  |  6 ++++
 packages/sample/genaisrc/pr-review.genai.mjs  |  6 ++++
 6 files changed, 32 insertions(+), 20 deletions(-)

diff --git a/.github/workflows/genai-commander.yml b/.github/workflows/genai-commander.yml
index 418253e5f9..60ce05641c 100644
--- a/.github/workflows/genai-commander.yml
+++ b/.github/workflows/genai-commander.yml
@@ -32,13 +32,13 @@ jobs:
               id: check_author
               uses: actions/github-script@v7
               with:
-                script: |
-                  const { owner, repo } = context.repo;
-                  const commentAuthor = context.payload.comment.user.login;
-                  const { data: collaborators } = await github.rest.repos.listCollaborators({ owner, repo });
-                  const isCollaborator = collaborators.some(collaborator => collaborator.login === commentAuthor);
-                  if (!isCollaborator)
-                    throw new Error(`user ${commentAuthor} is not a collaborator on this repository`);
+                  script: |
+                      const { owner, repo } = context.repo;
+                      const commentAuthor = context.payload.comment.user.login;
+                      const { data: collaborators } = await github.rest.repos.listCollaborators({ owner, repo });
+                      const isCollaborator = collaborators.some(collaborator => collaborator.login === commentAuthor);
+                      if (!isCollaborator)
+                        throw new Error(`user ${commentAuthor} is not a collaborator on this repository`);
             #
             # Resolve the PR sha and ref
             #
@@ -54,20 +54,20 @@ jobs:
                       console.log(res)
                       return JSON.stringify(res)
             #
-            # Checkout both main and PR branches
+            # Checkout both dev and PR branches
             #
             - name: checkout
               uses: actions/checkout@v4
               with:
                   fetch-depth: 0
             - name: diff PR branch
-              run: git diff origin/main...origin/${{ fromJSON(steps.sha.outputs.result).ref }}
+              run: git diff origin/dev...origin/${{ fromJSON(steps.sha.outputs.result).ref }}
             - name: diff PR commit
-              run: git diff origin/main...${{ fromJSON(steps.sha.outputs.result).sha }}
+              run: git diff origin/dev...${{ fromJSON(steps.sha.outputs.result).sha }}
             - name: checkout PR commit
               run: git checkout ${{ fromJSON(steps.sha.outputs.result).sha }}
-            - name: diff main
-              run: git diff origin/main
+            - name: diff dev
+              run: git diff origin/dev
             #
             # Setup and build project
             #
@@ -88,14 +88,14 @@ jobs:
             #
             - name: genaiscript pr-describe
               if: startsWith(github.event.comment.body, '/genai describe')
-              run: node packages/cli/built/genaiscript.cjs run pr-describe -prd --out-output $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-describe -prd --out-output $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               env:
                   GITHUB_ISSUE: ${{ github.event.issue.number }}
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
                   GITHUB_COMMIT_SHA: ${{ fromJSON(steps.sha.outputs.result).sha }}
             - name: genaiscript pr-review
               if: startsWith(github.event.comment.body, '/genai review')
-              run: node packages/cli/built/genaiscript.cjs run pr-review -prc --out-output $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-review -prc --out-output $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               env:
                   GITHUB_ISSUE: ${{ github.event.issue.number }}
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/genai-pr-commit-review.yml b/.github/workflows/genai-pr-commit-review.yml
index 91ad511936..5d16429ce4 100644
--- a/.github/workflows/genai-pr-commit-review.yml
+++ b/.github/workflows/genai-pr-commit-review.yml
@@ -33,9 +33,9 @@ jobs:
             - name: start ollama
               run: yarn ollama:start
             - name: git stuff
-              run: git fetch origin && git pull origin main:main
+              run: git fetch origin && git pull origin dev:dev
             - name: genaiscript pr-review-commit
-              run: node packages/cli/built/genaiscript.cjs run pr-review-commit --out ./temp/genai/pr-review-commit -prr --out-trace $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-review-commit --out ./temp/genai/pr-review-commit -prr --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               continue-on-error: true
               env:
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/genai-pr-docs-commit-review.yml b/.github/workflows/genai-pr-docs-commit-review.yml
index 47d5d6ed47..15c316aae8 100644
--- a/.github/workflows/genai-pr-docs-commit-review.yml
+++ b/.github/workflows/genai-pr-docs-commit-review.yml
@@ -30,9 +30,9 @@ jobs:
             - name: start ollama
               run: yarn ollama:start
             - name: git stuff
-              run: git fetch origin && git pull origin main:main
+              run: git fetch origin && git pull origin dev:dev
             - name: genaiscript pr-review-commit
-              run: node packages/cli/built/genaiscript.cjs run pr-docs-review-commit --out ./temp/genai/pr-docs-review-commit -prr --out-trace $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-docs-review-commit --out ./temp/genai/pr-docs-review-commit -prr --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               continue-on-error: true
               env:
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/genai-pr-review.yml b/.github/workflows/genai-pr-review.yml
index c3859ed077..9f90c0d9b7 100644
--- a/.github/workflows/genai-pr-review.yml
+++ b/.github/workflows/genai-pr-review.yml
@@ -41,11 +41,11 @@ jobs:
               run: git fetch origin && git pull origin main:main
             - name: genaiscript pr-describe
               continue-on-error: true
-              run: node packages/cli/built/genaiscript.cjs run pr-describe --out ./temp/genai/pr-describe -prd -m reasoning --out-trace $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-describe --out ./temp/genai/pr-describe -prd -m reasoning --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               env:
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
             - name: genaiscript pr-review
-              run: node packages/cli/built/genaiscript.cjs run pr-review --out ./temp/genai/pr-review -prc -m reasoning --out-trace $GITHUB_STEP_SUMMARY
+              run: node packages/cli/built/genaiscript.cjs run pr-review --out ./temp/genai/pr-review -prc -m reasoning --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               continue-on-error: true
               env:
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/packages/sample/genaisrc/pr-docs-review-commit.genai.mjs b/packages/sample/genaisrc/pr-docs-review-commit.genai.mjs
index ede10ceccc..7e855d8bef 100644
--- a/packages/sample/genaisrc/pr-docs-review-commit.genai.mjs
+++ b/packages/sample/genaisrc/pr-docs-review-commit.genai.mjs
@@ -5,6 +5,12 @@ script({
     title: "pull request docs review",
     system: ["system", "system.technical", "system.annotations"],
     tools: ["fs_find_files", "fs_read_file"],
+    parameters: {
+        defaultBranch: {
+            type: "string",
+            description: "The default branch to compare against.",
+        },
+    },
 })
 
 const defaultBranch = env.vars.defaultBranch || (await git.defaultBranch())
diff --git a/packages/sample/genaisrc/pr-review.genai.mjs b/packages/sample/genaisrc/pr-review.genai.mjs
index 5377ebb20f..f34c02bf79 100644
--- a/packages/sample/genaisrc/pr-review.genai.mjs
+++ b/packages/sample/genaisrc/pr-review.genai.mjs
@@ -3,6 +3,12 @@ script({
     title: "pull request review",
     system: ["system", "system.typescript"],
     tools: ["fs"],
+    parameters: {
+        defaultBranch: {
+            type: "string",
+            description: "The default branch to compare against.",
+        },
+    },
 })
 
 const defaultBranch = env.vars.defaultBranch || (await git.defaultBranch())

From b9635fb70b5c0bc4d0aad1b4a5e0a409fa7a15a2 Mon Sep 17 00:00:00 2001
From: Peli de Halleux <pelikhan@users.noreply.github.com>
Date: Wed, 2 Apr 2025 14:18:35 +0000
Subject: [PATCH 4/4] output trace again

---
 .github/workflows/genai-commander.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/genai-commander.yml b/.github/workflows/genai-commander.yml
index 60ce05641c..32aedf7e7d 100644
--- a/.github/workflows/genai-commander.yml
+++ b/.github/workflows/genai-commander.yml
@@ -88,14 +88,14 @@ jobs:
             #
             - name: genaiscript pr-describe
               if: startsWith(github.event.comment.body, '/genai describe')
-              run: node packages/cli/built/genaiscript.cjs run pr-describe -prd --out-output $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
+              run: node packages/cli/built/genaiscript.cjs run pr-describe -prd --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               env:
                   GITHUB_ISSUE: ${{ github.event.issue.number }}
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
                   GITHUB_COMMIT_SHA: ${{ fromJSON(steps.sha.outputs.result).sha }}
             - name: genaiscript pr-review
               if: startsWith(github.event.comment.body, '/genai review')
-              run: node packages/cli/built/genaiscript.cjs run pr-review -prc --out-output $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
+              run: node packages/cli/built/genaiscript.cjs run pr-review -prc --out-trace $GITHUB_STEP_SUMMARY --vars defaultBranch=dev
               env:
                   GITHUB_ISSUE: ${{ github.event.issue.number }}
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}