@jterrats/open-orchestra 0.1.0 → 0.2.1

package/dist/mcp-oauth-proxy.js

@@ -0,0 +1,80 @@
+import path from "node:path";
+export function evaluateMcpOAuthProxy(config) {
+    const risks = validateMcpOAuthProxyConfig(config);
+    return {
+        approved: risks.length === 0,
+        risks,
+        recommendations: [
+            "Keep the proxy opt-in and require user approval before writing MCP config.",
+            "Never log access tokens, refresh tokens, authorization codes, or token endpoint responses.",
+            "Support revocation by deleting local token material and re-running authorization.",
+        ],
+        modes: [
+            {
+                mode: "stdio-proxy",
+                summary: "A local process bridges stdio clients to HTTP MCP servers.",
+                tradeOff: "Best compatibility, but the proxy owns token injection and refresh risk.",
+            },
+            {
+                mode: "direct-http",
+                summary: "The client connects directly to the HTTP MCP server.",
+                tradeOff: "Simpler runtime, but only works when the tool supports HTTP MCP and auth.",
+            },
+            {
+                mode: "tool-native-oauth",
+                summary: "The IDE or CLI handles OAuth and MCP transport itself.",
+                tradeOff: "Best security ownership, but availability depends on each tool runtime.",
+            },
+        ],
+    };
+}
+export function validateMcpOAuthProxyConfig(config) {
+    const risks = [];
+    if (!config.enabled) {
+        risks.push("proxy is disabled; no MCP config should be changed");
+    }
+    if (!config.approvedBy) {
+        risks.push("missing explicit user approval");
+    }
+    if (!config.serverUrl.startsWith("https://")) {
+        risks.push("serverUrl must use https");
+    }
+    if (config.refreshWindowSeconds < 30) {
+        risks.push("refreshWindowSeconds must be at least 30");
+    }
+    if (config.tokenStorage === "secure-file") {
+        if (!config.tokenPath) {
+            risks.push("secure-file token storage requires tokenPath");
+        }
+        else if (!isSecureLocalTokenPath(config.tokenPath)) {
+            risks.push("tokenPath must stay under an approved local secret directory");
+        }
+    }
+    return risks;
+}
+export async function refreshMcpTokenIfNeeded({ token, now = new Date(), refreshWindowSeconds, refresh, }) {
+    const expiresAt = new Date(token.expiresAt);
+    const refreshAt = expiresAt.getTime() - refreshWindowSeconds * 1000;
+    if (now.getTime() < refreshAt) {
+        return {
+            refreshed: false,
+            reason: "token still valid outside refresh window",
+            token,
+        };
+    }
+    return {
+        refreshed: true,
+        reason: "token refreshed inside refresh window",
+        token: await refresh(token),
+    };
+}
+function isSecureLocalTokenPath(tokenPath) {
+    const normalized = path.normalize(tokenPath);
+    const home = process.env.HOME ? path.normalize(process.env.HOME) : "";
+    const approvedPrefixes = [
+        path.join(home, ".config", "open-orchestra", "secrets"),
+        path.join(home, ".local", "share", "open-orchestra", "secrets"),
+    ];
+    return approvedPrefixes.some((prefix) => normalized === prefix || normalized.startsWith(prefix + path.sep));
+}
+//# sourceMappingURL=mcp-oauth-proxy.js.map

package/dist/mcp-oauth-proxy.js.map

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

package/dist/pr-review.d.ts

@@ -0,0 +1,20 @@
+import type { EventEntry, LockEntry, Task } from "./types.js";
+export interface PullRequestReviewAnalysis {
+    behaviorSummary: string;
+    changedFiles: string[];
+    testEvidence: string[];
+    unresolvedQuestions: string[];
+    requiredReviewers: string[];
+    missingReviewers: string[];
+    checklist: string[];
+    evidenceGaps: string[];
+    mergeBlocked: boolean;
+    mergeBlockers: string[];
+}
+export declare function analyzePullRequestReview(input: {
+    task: Task;
+    reviews: EventEntry[];
+    evidence: EventEntry[];
+    gates: EventEntry[];
+    locks: LockEntry[];
+}): PullRequestReviewAnalysis;

package/dist/pr-review.js

@@ -0,0 +1,142 @@
+export function analyzePullRequestReview(input) {
+    const changedFiles = input.task.paths ?? [];
+    const requiredReviewers = requiredReviewersForTask(input.task, changedFiles);
+    const approvedReviewers = approvedReviewersFromEvents(input.reviews);
+    const missingReviewers = requiredReviewers.filter((reviewer) => !approvedReviewers.has(reviewer));
+    const evidenceGaps = missingEvidenceForTask(input.task, input.evidence);
+    const unresolvedQuestions = unresolvedQuestionsForTask(input.task, input.gates);
+    const mergeBlockers = [
+        ...missingReviewers.map((role) => "missing required review: " + role),
+        ...evidenceGaps.map((gap) => "missing evidence: " + gap),
+        ...input.locks.map((lock) => "active lock: " + lock.path),
+        ...input.reviews
+            .filter((review) => review.metadata.result === "block")
+            .map((review) => "blocking review: " + review.actor),
+        ...unresolvedQuestions.map((question) => "unresolved question: " + question),
+    ];
+    return {
+        behaviorSummary: behaviorSummaryForTask(input.task),
+        changedFiles,
+        testEvidence: input.evidence.map((event) => event.summary),
+        unresolvedQuestions,
+        requiredReviewers,
+        missingReviewers,
+        checklist: checklistForChangedFiles(changedFiles),
+        evidenceGaps,
+        mergeBlocked: mergeBlockers.length > 0,
+        mergeBlockers,
+    };
+}
+function behaviorSummaryForTask(task) {
+    return task.goal ?? task.scope ?? task.title;
+}
+function requiredReviewersForTask(task, changedFiles) {
+    const reviewers = new Set(["tech_lead", "qa"]);
+    const lowerRisks = [
+        ...(task.risks ?? []),
+        ...(task.riskGate?.impactAreas ?? []),
+    ].map((risk) => risk.toLowerCase());
+    for (const filePath of changedFiles) {
+        addReviewersForPath(filePath, reviewers);
+    }
+    for (const risk of lowerRisks) {
+        addReviewersForRisk(risk, reviewers);
+    }
+    if (task.architectureApproval ||
+        /architecture|design|service|api/i.test(task.scope ?? "")) {
+        reviewers.add("architect");
+    }
+    return Array.from(reviewers).sort();
+}
+function addReviewersForPath(filePath, reviewers) {
+    if (/\.(tsx|jsx|css|scss)$|src\/web|app\/|pages\//.test(filePath)) {
+        reviewers.add("frontend_specialist");
+        reviewers.add("ux_ui_designer");
+    }
+    if (/server|api|service|backend|\.sql$|migrations?\//.test(filePath)) {
+        reviewers.add("backend_specialist");
+    }
+    if (/\.sql$|migrations?\//.test(filePath)) {
+        reviewers.add("dba");
+    }
+    if (/Dockerfile|docker-compose|\.github\/workflows|terraform|infra\//.test(filePath)) {
+        reviewers.add("devops");
+    }
+    if (/auth|security|secret|permission|policy/.test(filePath)) {
+        reviewers.add("security");
+    }
+    if (/test|spec|playwright|e2e/.test(filePath)) {
+        reviewers.add("sdet");
+    }
+}
+function addReviewersForRisk(risk, reviewers) {
+    const reviewerByRisk = {
+        security: "security",
+        devops: "devops",
+        sre: "sre",
+        dba: "dba",
+        ux: "ux_ui_designer",
+        release: "release_manager",
+        compliance: "compliance_privacy",
+    };
+    const reviewer = reviewerByRisk[risk];
+    if (reviewer) {
+        reviewers.add(reviewer);
+    }
+}
+function approvedReviewersFromEvents(reviews) {
+    return new Set(reviews
+        .filter((review) => review.metadata.result === "approve")
+        .map((review) => review.actor));
+}
+function missingEvidenceForTask(task, evidence) {
+    const gaps = [];
+    if (!evidence.some((event) => event.type === "EVIDENCE_ADDED")) {
+        gaps.push("test evidence");
+    }
+    if ((task.paths ?? []).some((filePath) => /tsx|jsx|playwright|e2e/.test(filePath))) {
+        const hasBrowserEvidence = evidence.some((event) => /screenshot|trace|browser|playwright/i.test(event.summary));
+        if (!hasBrowserEvidence) {
+            gaps.push("browser evidence");
+        }
+    }
+    if (!evidence.some((event) => /rollback|rollout/i.test(event.summary))) {
+        gaps.push("rollout or rollback note");
+    }
+    return gaps;
+}
+function unresolvedQuestionsForTask(task, gates) {
+    const questions = [];
+    if (task.status === "blocked" && task.blockedReason) {
+        questions.push(task.blockedReason);
+    }
+    for (const gate of gates) {
+        if (gate.type === "GATE_BLOCKED") {
+            questions.push(gate.summary);
+        }
+    }
+    return questions;
+}
+function checklistForChangedFiles(changedFiles) {
+    const checklist = new Set([
+        "Confirm user-visible behavior matches acceptance criteria.",
+        "Confirm tests and evidence cover changed behavior.",
+        "Confirm rollback or forward-fix path is documented.",
+    ]);
+    for (const filePath of changedFiles) {
+        if (/\.(ts|tsx|js|jsx)$/.test(filePath)) {
+            checklist.add("Check type safety, error handling, and public API contracts.");
+        }
+        if (/tsx|jsx|css|scss|src\/web|app\/|pages\//.test(filePath)) {
+            checklist.add("Check responsive UI, accessibility, and browser evidence.");
+        }
+        if (/Dockerfile|\.github\/workflows|terraform|infra\//.test(filePath)) {
+            checklist.add("Check CI/CD, secrets, rollback, and runtime configuration impact.");
+        }
+        if (/\.sql$|migrations?\//.test(filePath)) {
+            checklist.add("Check migration reversibility, data safety, and DBA approval.");
+        }
+    }
+    return Array.from(checklist).sort();
+}
+//# sourceMappingURL=pr-review.js.map

package/dist/pr-review.js.map

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

package/dist/project-detection.d.ts

@@ -0,0 +1,22 @@
+export interface ProjectSignal {
+    id: string;
+    label: string;
+    evidence: string[];
+    recommendedRoles: string[];
+    recommendedSkills: string[];
+    sourceGroups: string[];
+}
+export interface ProjectDetectionReport {
+    root: string;
+    signals: ProjectSignal[];
+    recommendedRoles: string[];
+    recommendedSkills: string[];
+    sourceGroups: string[];
+    reviewRequired: boolean;
+    accepted: boolean;
+}
+export declare function detectProjectProfile(root?: string): Promise<ProjectDetectionReport>;
+export declare function acceptDetectedProjectProfile({ root, outputPath, }?: {
+    root?: string;
+    outputPath?: string;
+}): Promise<ProjectDetectionReport>;

package/dist/project-detection.js

@@ -0,0 +1,174 @@
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { exists, resolveWorkspaceWritePath, writeJson } from "./fs-utils.js";
+const SIGNAL_RULES = [
+    {
+        id: "node-package-manager",
+        label: "Node package manager",
+        roles: ["developer", "tech_lead"],
+        skills: ["static-analysis", "prompt-registry"],
+        sourceGroups: ["codebase", "quality-security"],
+        paths: ["package.json", "package-lock.json", "yarn.lock", "pnpm-lock.yaml"],
+    },
+    {
+        id: "playwright",
+        label: "Playwright browser testing",
+        roles: ["qa", "sdet", "frontend_specialist"],
+        skills: ["playwright-evidence", "static-analysis"],
+        sourceGroups: ["quality-security", "codebase"],
+        paths: ["playwright.config.ts", "playwright.config.js", "e2e", "tests/e2e"],
+        packageNames: ["@playwright/test", "playwright"],
+    },
+    {
+        id: "github-actions",
+        label: "GitHub Actions workflows",
+        roles: ["devops", "platform_engineer"],
+        skills: ["static-analysis", "release-readiness"],
+        sourceGroups: ["devops-runtime", "quality-security"],
+        paths: [".github/workflows"],
+    },
+    {
+        id: "containers",
+        label: "Docker or Compose runtime",
+        roles: ["devops", "sre", "security"],
+        skills: ["static-analysis", "release-readiness"],
+        sourceGroups: ["devops-runtime", "quality-security"],
+        paths: ["Dockerfile", "docker-compose.yml", "compose.yml"],
+    },
+    {
+        id: "iac",
+        label: "Infrastructure as Code",
+        roles: ["devops", "security", "sre"],
+        skills: ["static-analysis", "diagram-export"],
+        sourceGroups: ["devops-runtime", "quality-security", "architecture"],
+        paths: ["terraform", "infra", "infrastructure"],
+        extensions: [".tf", ".tfvars"],
+    },
+    {
+        id: "frontend",
+        label: "Frontend application",
+        roles: ["frontend_specialist", "ux_designer", "accessibility_specialist"],
+        skills: ["playwright-evidence", "static-analysis"],
+        sourceGroups: ["codebase", "quality-security"],
+        paths: ["src/App.tsx", "src/App.jsx", "src/main.tsx", "src/pages", "app"],
+        packageNames: ["react", "vue", "@angular/core", "next", "vite"],
+    },
+    {
+        id: "python",
+        label: "Python project",
+        roles: ["developer", "backend_specialist", "qa"],
+        skills: ["static-analysis", "prompt-registry"],
+        sourceGroups: ["codebase", "quality-security"],
+        paths: ["pyproject.toml", "requirements.txt", "setup.py"],
+        extensions: [".py"],
+    },
+    {
+        id: "api-service",
+        label: "API or service layer",
+        roles: ["backend_specialist", "security", "sre"],
+        skills: ["static-analysis", "release-readiness"],
+        sourceGroups: ["codebase", "quality-security", "devops-runtime"],
+        paths: ["src/api", "src/server.ts", "src/server.js", "services", "backend"],
+        packageNames: ["express", "fastify", "@nestjs/core", "hono"],
+    },
+];
+export async function detectProjectProfile(root = process.cwd()) {
+    const packageNames = await readPackageDependencyNames(root);
+    const allFiles = await listProjectFiles(root);
+    const signals = [];
+    for (const rule of SIGNAL_RULES) {
+        const evidence = await collectSignalEvidence(root, allFiles, packageNames, rule);
+        if (evidence.length > 0) {
+            signals.push({
+                id: rule.id,
+                label: rule.label,
+                evidence,
+                recommendedRoles: [...rule.roles],
+                recommendedSkills: [...rule.skills],
+                sourceGroups: [...rule.sourceGroups],
+            });
+        }
+    }
+    return {
+        root,
+        signals,
+        recommendedRoles: unique(signals.flatMap((signal) => signal.recommendedRoles)),
+        recommendedSkills: unique(signals.flatMap((signal) => signal.recommendedSkills)),
+        sourceGroups: unique(signals.flatMap((signal) => signal.sourceGroups)),
+        reviewRequired: signals.length > 0,
+        accepted: false,
+    };
+}
+export async function acceptDetectedProjectProfile({ root = process.cwd(), outputPath = ".agent-workflow/detected-profile.json", } = {}) {
+    const report = { ...(await detectProjectProfile(root)), accepted: true };
+    const resolvedOutputPath = resolveWorkspaceWritePath(root, outputPath);
+    await writeJson(resolvedOutputPath, report);
+    return report;
+}
+async function collectSignalEvidence(root, allFiles, packageNames, rule) {
+    const pathEvidence = await existingSignalPaths(root, rule.paths ?? []);
+    const extensionEvidence = (rule.extensions ?? []).flatMap((extension) => allFiles.filter((filePath) => filePath.endsWith(extension)).slice(0, 3));
+    const packageEvidence = (rule.packageNames ?? [])
+        .filter((packageName) => packageNames.has(packageName))
+        .map((packageName) => "package:" + packageName);
+    return unique([...pathEvidence, ...extensionEvidence, ...packageEvidence]);
+}
+async function existingSignalPaths(root, candidatePaths) {
+    const foundPaths = [];
+    for (const candidatePath of candidatePaths) {
+        if (await exists(path.resolve(root, candidatePath))) {
+            foundPaths.push(candidatePath);
+        }
+    }
+    return foundPaths;
+}
+async function readPackageDependencyNames(root) {
+    const packagePath = path.resolve(root, "package.json");
+    if (!(await exists(packagePath))) {
+        return new Set();
+    }
+    const packageJson = JSON.parse(await readFile(packagePath, "utf8"));
+    return new Set([
+        ...Object.keys(packageJson.dependencies ?? {}),
+        ...Object.keys(packageJson.devDependencies ?? {}),
+    ]);
+}
+async function listProjectFiles(root) {
+    const files = [];
+    await collectProjectFiles(root, "", files);
+    return files;
+}
+async function collectProjectFiles(root, relativeDirectory, files) {
+    const directory = path.join(root, relativeDirectory);
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (shouldSkipDirectory(entry.name)) {
+            continue;
+        }
+        const relativePath = path.join(relativeDirectory, entry.name);
+        if (entry.isDirectory()) {
+            await collectProjectFiles(root, relativePath, files);
+            continue;
+        }
+        files.push(relativePath);
+    }
+}
+function shouldSkipDirectory(name) {
+    return [
+        ".git",
+        "node_modules",
+        "dist",
+        "coverage",
+        ".agent-workflow",
+    ].includes(name);
+}
+function unique(values) {
+    return Array.from(new Set(values)).sort();
+}
+//# sourceMappingURL=project-detection.js.map

package/dist/project-detection.js.map

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

package/dist/prompt-registry.d.ts

@@ -0,0 +1,56 @@
+export declare const PROMPT_REGISTRY_DIR = ".generated-prompts";
+declare const REGISTER_FILES: {
+    readonly "code.md": {
+        readonly title: "Code Generation Prompts";
+        readonly covers: "source code, refactors, shared modules, and implementation-heavy changes";
+        readonly usage: readonly ["Read this file before creating or substantially changing source code.", "Use previous entries to preserve naming, layering, module ownership, and test patterns.", "Update the matching component entry when behavior, responsibility, or architecture changes."];
+    };
+    readonly "ui.md": {
+        readonly title: "UI and UX Prompts";
+        readonly covers: "frontend screens, components, responsive layouts, UI copy, and accessibility-sensitive work";
+        readonly usage: readonly ["Read this file before changing user-facing UI.", "Preserve mobile-first decisions, state coverage, accessibility constraints, and visual language.", "Update entries for new flows, component state changes, or significant copy/interaction changes."];
+    };
+    readonly "services.md": {
+        readonly title: "Service and Domain Prompts";
+        readonly covers: "domain models, service boundaries, API contracts, data flow, and backend behavior";
+        readonly usage: readonly ["Read this file before changing domain logic, service contracts, or persistence integration.", "Preserve API conventions, failure-mode decisions, idempotency, retries, and data ownership.", "Update entries when contracts, business rules, or service responsibilities change."];
+    };
+    readonly "tests.md": {
+        readonly title: "Test and Evidence Prompts";
+        readonly covers: "unit tests, integration tests, Playwright specs, QA plans, fixtures, and evidence strategy";
+        readonly usage: readonly ["Read this file before creating tests or QA automation.", "Preserve fixture strategy, page object patterns, locator conventions, and evidence requirements.", "Update entries for substantial test plan, Playwright, or regression coverage changes."];
+    };
+    readonly "cicd.md": {
+        readonly title: "CI/CD and Infrastructure Prompts";
+        readonly covers: "workflow YAML, deployment scripts, IaC, runtime config, observability, and rollback automation";
+        readonly usage: readonly ["Read this file before changing CI/CD, infra, environments, release, or runtime configuration.", "Preserve secret naming, gate order, rollback assumptions, and deployment safety constraints.", "Update entries for new pipelines, deployment stages, infrastructure modules, or operational gates."];
+    };
+    readonly "docs.md": {
+        readonly title: "Documentation Prompts";
+        readonly covers: "ADRs, runbooks, release notes, user docs, support docs, and technical guides";
+        readonly usage: readonly ["Read this file before generating or substantially revising documentation.", "Preserve audience, structure, tone, decision history, and links to related artifacts.", "Update entries when docs capture new decisions, release behavior, runbooks, or support guidance."];
+    };
+    readonly "diagrams.md": {
+        readonly title: "Diagram Prompts";
+        readonly covers: "architecture diagrams, workflow maps, Mermaid, Lucid, draw.io, and visual explanations";
+        readonly usage: readonly ["Read this file before creating or changing diagrams.", "Preserve diagram notation, scope boundaries, naming, and source-of-truth decisions.", "Update entries when a diagram changes architecture, data flow, or operational interpretation."];
+    };
+    readonly "evals.md": {
+        readonly title: "AI Evaluation and Prompt Quality Prompts";
+        readonly covers: "LLM evals, prompt changes, model routing, provider fallback, rubrics, and AI behavior evidence";
+        readonly usage: readonly ["Read this file before changing prompts, model routing, provider fallback, or eval criteria.", "Preserve eval objectives, datasets, rubrics, model comparison notes, and accepted residual risks.", "Update entries when LLM behavior, scoring, or prompt quality expectations change."];
+    };
+};
+export type PromptRegistryFileName = keyof typeof REGISTER_FILES;
+export interface PromptRegistryWriteResult {
+    written: string[];
+    skipped: string[];
+}
+export declare function promptRegistryFileNames(): PromptRegistryFileName[];
+export declare function buildPromptRegistryFile(name: PromptRegistryFileName): string;
+export declare function initPromptRegistry({ root, force, }?: {
+    root?: string | undefined;
+    force?: boolean | undefined;
+}): Promise<PromptRegistryWriteResult>;
+export declare function readPromptRegistryFile(root: string, name: PromptRegistryFileName): Promise<string>;
+export {};