@junctionpanel/server 0.1.82 → 0.1.84

package/dist/server/shared/switchboard.js

@@ -0,0 +1,172 @@
+import { z } from "zod";
+export const SWITCHBOARD_WORKFLOW_FILE = "SWITCHBOARD.md";
+export const SWITCHBOARD_MANAGED_BY_LABEL = "junction:managed-by";
+export const SWITCHBOARD_MANAGED_BY_VALUE = "switchboard";
+export const SWITCHBOARD_PROJECT_ID_LABEL = "junction:switchboard-project-id";
+export const SWITCHBOARD_PROJECT_KEY_LABEL = "junction:switchboard-project-key";
+export const SWITCHBOARD_RUN_ID_LABEL = "junction:switchboard-run-id";
+export const SWITCHBOARD_ISSUE_LABEL = "junction:switchboard-issue";
+const SwitchboardTrackerSchema = z
+    .object({
+    provider: z.enum(["manual", "linear"]).default("manual"),
+    teamKey: z.string().trim().min(1).max(32).optional(),
+    projectId: z.string().trim().min(1).max(128).optional(),
+    defaultStateName: z.string().trim().min(1).max(100).optional(),
+})
+    .strict();
+const SwitchboardDefaultsSchema = z
+    .object({
+    agentProvider: z.string().trim().min(1).max(64).default("codex"),
+    baseBranch: z.string().trim().min(1).max(255).optional(),
+    remoteName: z.string().trim().min(1).max(255).optional(),
+    worktreePrefix: z.string().trim().min(1).max(64).default("switchboard"),
+    maxConcurrentRuns: z.number().int().min(1).max(20).default(1),
+})
+    .strict();
+const SwitchboardPromptSchema = z
+    .object({
+    system: z.string().trim().min(1),
+    successDefinition: z.string().trim().min(1).optional(),
+    includeIssueDescription: z.boolean().default(true),
+    includeIssueIdentifier: z.boolean().default(true),
+})
+    .strict();
+const SwitchboardAutomationSchema = z
+    .object({
+    enabled: z.boolean().default(true),
+    autoStart: z.boolean().default(false),
+    pollIntervalSeconds: z.number().int().min(30).max(3600).default(300),
+})
+    .strict();
+export const SwitchboardWorkflowSchema = z
+    .object({
+    version: z.literal(1),
+    project: z
+        .object({
+        name: z.string().trim().min(1).max(255).optional(),
+        tracker: SwitchboardTrackerSchema.default({ provider: "manual" }),
+    })
+        .strict()
+        .default({
+        tracker: { provider: "manual" },
+    }),
+    defaults: SwitchboardDefaultsSchema.default({
+        agentProvider: "codex",
+        worktreePrefix: "switchboard",
+        maxConcurrentRuns: 1,
+    }),
+    prompt: SwitchboardPromptSchema,
+    labels: z.record(z.string().trim().min(1).max(255)).default({}),
+    automation: SwitchboardAutomationSchema.default({
+        enabled: true,
+        autoStart: false,
+        pollIntervalSeconds: 300,
+    }),
+})
+    .strict();
+export const SWITCHBOARD_WORKFLOW_TEMPLATE = `# Switchboard
+
+This repository is operated by Junction Switchboard.
+
+\`\`\`switchboard
+{
+  "version": 1,
+  "project": {
+    "tracker": {
+      "provider": "manual"
+    }
+  },
+  "defaults": {
+    "agentProvider": "codex",
+    "worktreePrefix": "switchboard",
+    "maxConcurrentRuns": 1
+  },
+  "prompt": {
+    "system": "Own the issue end-to-end. Make the code changes, run the relevant checks, and leave the branch ready for review.",
+    "successDefinition": "The issue is implemented, relevant checks pass, and the branch is ready for a Junction code review.",
+    "includeIssueDescription": true,
+    "includeIssueIdentifier": true
+  },
+  "labels": {},
+  "automation": {
+    "enabled": true,
+    "autoStart": false,
+    "pollIntervalSeconds": 300
+  }
+}
+\`\`\`
+`;
+function extractSwitchboardCodeBlock(content) {
+    const match = content.match(/```switchboard\s*\n([\s\S]*?)\n```/i);
+    if (!match) {
+        return null;
+    }
+    return match[1]?.trim() ?? null;
+}
+export function parseSwitchboardWorkflowFile(content) {
+    const sourceBlock = extractSwitchboardCodeBlock(content);
+    if (!sourceBlock) {
+        return {
+            status: "missing_block",
+            message: "`SWITCHBOARD.md` must contain a ```switchboard fenced code block with JSON workflow settings.",
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(sourceBlock);
+    }
+    catch (error) {
+        return {
+            status: "invalid_json",
+            message: error instanceof Error ? error.message : "Invalid JSON in `SWITCHBOARD.md`.",
+        };
+    }
+    const result = SwitchboardWorkflowSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((issue) => {
+            const path = issue.path.length > 0 ? issue.path.join(".") : "root";
+            return `${path}: ${issue.message}`;
+        })
+            .join("; ");
+        return {
+            status: "invalid_schema",
+            message: issues || "Invalid `SWITCHBOARD.md` workflow schema.",
+        };
+    }
+    return {
+        status: "valid",
+        workflow: result.data,
+        sourceBlock,
+    };
+}
+export function buildSwitchboardRunPrompt(input) {
+    const sections = [input.workflow.prompt.system.trim()];
+    const issueLines = [];
+    if (input.workflow.prompt.includeIssueIdentifier && input.issueIdentifier?.trim()) {
+        issueLines.push(`Issue: ${input.issueIdentifier.trim()}`);
+    }
+    issueLines.push(`Title: ${input.issueTitle.trim()}`);
+    if (input.workflow.prompt.includeIssueDescription) {
+        const description = input.issueDescription?.trim();
+        if (description) {
+            issueLines.push(`Description:\n${description}`);
+        }
+    }
+    sections.push(issueLines.join("\n"));
+    const successDefinition = input.workflow.prompt.successDefinition?.trim();
+    if (successDefinition) {
+        sections.push(`Success definition:\n${successDefinition}`);
+    }
+    sections.push("Use the repository's existing Junction configuration and keep the worktree ready for review when you finish.");
+    return sections.join("\n\n");
+}
+export function sanitizeSwitchboardSlugPart(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized.length > 0 ? normalized.slice(0, 48) : "run";
+}
+//# sourceMappingURL=switchboard.js.map

package/dist/server/shared/switchboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchboard.js","sourceRoot":"","sources":["../../../src/shared/switchboard.ts"],"names":[],"mappings":"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"}

package/dist/server/utils/worktree-metadata.d.ts

@@ -3,11 +3,11 @@ declare const JunctionWorktreeMetadataSchema: z.ZodUnion<[z.ZodObject<{
     version: z.ZodLiteral<1>;
     baseRefName: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    baseRefName: string;
     version: 1;
-}, {
     baseRefName: string;
+}, {
     version: 1;
+    baseRefName: string;
 }>, z.ZodObject<{
     version: z.ZodLiteral<2>;
     baseRefName: z.ZodString;
@@ -19,14 +19,14 @@ declare const JunctionWorktreeMetadataSchema: z.ZodUnion<[z.ZodObject<{
         worktreePort: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    baseRefName: string;
     version: 2;
+    baseRefName: string;
     runtime?: {
         worktreePort: number;
     } | undefined;
 }, {
-    baseRefName: string;
     version: 2;
+    baseRefName: string;
     runtime?: {
         worktreePort: number;
     } | undefined;
@@ -43,17 +43,17 @@ declare const JunctionWorktreeMetadataSchema: z.ZodUnion<[z.ZodObject<{
         worktreePort: number;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    version: 3;
     baseBranchSource: "local" | "remote";
     baseRefName: string;
-    version: 3;
     remoteName?: string | undefined;
     runtime?: {
         worktreePort: number;
     } | undefined;
 }, {
+    version: 3;
     baseBranchSource: "local" | "remote";
     baseRefName: string;
-    version: 3;
     remoteName?: string | undefined;
     runtime?: {
         worktreePort: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junctionpanel/server",
-  "version": "0.1.82",
+  "version": "0.1.84",
   "description": "Junction backend server",
   "type": "module",
   "publishConfig": {
@@ -70,7 +70,7 @@
     "ws": "^8.14.2",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.1",
-    "@junctionpanel/relay": "0.1.82"
+    "@junctionpanel/relay": "0.1.84"
   },
   "devDependencies": {
     "@playwright/test": "^1.56.1",