@ddtcorex/dsh-maestro-review 0.1.0

package/lib/govard-tool.js

@@ -0,0 +1,95 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import z from '@deepseek-ai/schemastery';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+export const name = 'maestro-govard-tool';
+export const inject = ['tools'];
+export const Config = z.object({
+    rootPath: z.string(),
+    timeoutMs: z.number().min(1_000).default(300_000),
+});
+function run(command, args, cwd, timeoutMs) {
+    return new Promise((promiseResolve, promiseReject) => {
+        const child = spawn(command, args, { cwd });
+        let stdout = '';
+        let stderr = '';
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            promiseReject(new Error(`"${command} ${args.join(' ')}" timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        child.stdout?.on('data', (chunk) => { stdout += chunk.toString(); });
+        child.stderr?.on('data', (chunk) => { stderr += chunk.toString(); });
+        child.on('error', (err) => {
+            clearTimeout(timer);
+            promiseReject(err);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            promiseResolve({ code, stdout, stderr });
+        });
+    });
+}
+function textResult(result, successText) {
+    if (result.code !== 0) {
+        throw new Error(`Exit ${result.code}: ${result.stderr || result.stdout}`);
+    }
+    return { text: result.stdout.length > 0 ? result.stdout : successText };
+}
+export function apply(ctx, config) {
+    const rootPath = config.rootPath ?? process.cwd();
+    const timeoutMs = config.timeoutMs ?? 300_000;
+    async function ensureInitialized() {
+        if (existsSync(join(rootPath, '.govard.yml')))
+            return;
+        const result = await run('govard', ['init', '--framework', 'magento2', '-y'], rootPath, timeoutMs);
+        if (result.code !== 0)
+            throw new Error(`govard init failed: ${result.stderr || result.stdout}`);
+    }
+    ctx.tools.register(defineTool({
+        name: 'govard_env_up',
+        description: 'Bring up the local Magento 2 Govard environment for the current worktree, initializing it first if needed.',
+        parameters: {},
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', required: true } } },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        async execute() {
+            await ensureInitialized();
+            const result = await run('govard', ['up'], rootPath, timeoutMs);
+            return textResult(result, 'Environment is up.');
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'govard_shell',
+        description: 'Run one non-interactive command inside the Govard-managed container (e.g. a test suite) and return its output.',
+        parameters: {
+            command: { type: 'string', required: true, description: 'Shell command to run inside the container, e.g. "vendor/bin/phpunit".' },
+        },
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', required: true } } },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        async execute(args) {
+            const result = await run('govard', ['shell', '-c', args.command], rootPath, timeoutMs);
+            return textResult(result, '(no output)');
+        },
+    }));
+    ctx.tools.register(defineTool({
+        name: 'govard_env_down',
+        description: 'Tear down the local Govard environment for the current worktree, removing volumes.',
+        parameters: {},
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: { text: { type: 'string', required: true } } },
+            render: (_args, value) => [{ type: 'text', text: value.text }],
+        },
+        async execute() {
+            const result = await run('govard', ['down', '-v'], rootPath, timeoutMs);
+            return textResult(result, 'Environment is down.');
+        },
+    }));
+    ctx.effect(() => async () => {
+        await run('govard', ['down', '-v'], rootPath, timeoutMs).catch(() => undefined);
+    }, 'govard-tool teardown');
+}
+//# sourceMappingURL=govard-tool.js.map

package/lib/govard-tool.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "@ddtcorex/dsh-maestro-review";
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,eAAO,MAAM,IAAI,iCAAiC,CAAA;AAElD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAUxC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+export const name = '@ddtcorex/dsh-maestro-review';
+export function apply(ctx) {
+    ctx.effect(() => ctx.connection.rpc.handle('/dsh-maestro-review', async (endpoint, payload) => {
+        if (endpoint === 'status')
+            return { ok: true, value: { provider: 'gitlab' } };
+        if (endpoint === 'providers')
+            return { ok: true, value: { providers: ['gitlab', 'github'] } };
+        if (endpoint === 'review') {
+            const body = payload;
+            return { ok: true, value: { received: true, provider: body?.provider ?? 'gitlab' } };
+        }
+        return { ok: false, error: { code: 'bad-request', message: `Unknown endpoint: ${endpoint}`, details: { issues: [{ message: String(endpoint) }] } } };
+    }, { authority: 'loopback' }), 'maestro-review rpc');
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,IAAI,GAAG,8BAA8B,CAAA;AAElD,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC5F,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAA;QAC7E,IAAI,QAAQ,KAAK,WAAW;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAA;QAC7F,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,OAA8C,CAAA;YAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAG,IAAY,EAAE,QAAQ,IAAI,QAAQ,EAAE,EAAE,CAAA;QAC/F,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAS,EAAE,EAAE,CAAA;IAC7J,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAA;AACtD,CAAC"}

package/lib/notify.d.ts

@@ -0,0 +1,23 @@
+/** Provider-neutral notifier contract plus every message text this plugin owns. */
+export interface NotifyDeliveryResult {
+    sent: boolean;
+    reason?: 'not-configured' | 'request-failed' | 'unknown-provider';
+}
+/**
+ * Structural view of the optional `maestroNotifier` service published by
+ * `@ddtcorex/dsh-maestro-notifier`. Consumed via `ctx.get` so an absent
+ * notifier plugin degrades to "no notifications" instead of breaking reviews.
+ */
+export interface NotifierLike {
+    send(providerId: string, target: Record<string, unknown>, message: {
+        text: string;
+    }): Promise<NotifyDeliveryResult>;
+}
+export declare function reviewDigestText(notification: {
+    projectPath: string;
+    mrIid: number;
+    status: 'completed' | 'failed';
+    summary?: string;
+}): string;
+export declare function pinRotationText(pin: string): string;
+//# sourceMappingURL=notify.d.ts.map

package/lib/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,kBAAkB,CAAA;CAClE;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CACpH;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,MAAM,CAIT;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/lib/notify.js

@@ -0,0 +1,10 @@
+/** Provider-neutral notifier contract plus every message text this plugin owns. */
+export function reviewDigestText(notification) {
+    const outcome = notification.status === 'completed' ? '✅ completed' : '⚠️ failed';
+    const summary = notification.summary === undefined ? '' : `\n${notification.summary}`;
+    return `Maestro review of ${notification.projectPath} !${notification.mrIid}: ${outcome}${summary}`;
+}
+export function pinRotationText(pin) {
+    return `DSH public access PIN was rotated\nNew PIN: ${pin}`;
+}
+//# sourceMappingURL=notify.js.map

package/lib/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAgBnF,MAAM,UAAU,gBAAgB,CAAC,YAKhC;IACC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAA;IACjF,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,OAAO,EAAE,CAAA;IACrF,OAAO,qBAAqB,YAAY,CAAC,WAAW,KAAK,YAAY,CAAC,KAAK,KAAK,OAAO,GAAG,OAAO,EAAE,CAAA;AACrG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,+CAA+C,GAAG,EAAE,CAAA;AAC7D,CAAC"}

package/lib/orchestrator.d.ts

@@ -0,0 +1,144 @@
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { ModelSelection } from '@deepseek-ai/dsh-agent';
+import type { ReviewFinding } from './review-findings-tool.js';
+import type { ReviewRequest } from './events.js';
+import { type MaestroUserConfig, type ReviewModelSelection } from './config-store.js';
+import { type ReviewSkillProfile } from './skills-tool.js';
+import type { ReviewProvider } from './providers/interface.js';
+import { gitlabProvider } from './providers/gitlab.js';
+import './events.js';
+export declare function runReviewWithProvider(provider: ReviewProvider, request: {
+    provider: string;
+    projectPath: string;
+    mrId: string;
+    profile: string;
+}): Promise<void>;
+export { gitlabProvider };
+export declare const name = "maestro-orchestrator";
+export declare const inject: string[];
+/** Convert DSH's selected default model into the options required by a child Agent. */
+export declare function agentOptionsForModel(selection: ModelSelection): ModelSelection;
+/**
+ * Resolve the model to use for an automated review. Priority: per-project
+ * override > global reviewModel > DSH default (`fallback`).
+ */
+export declare function resolveReviewModel(userConfig: MaestroUserConfig, mapping: {
+    reviewModel?: ReviewModelSelection | null;
+} & Record<string, unknown> | undefined, fallback: ModelSelection): ModelSelection;
+/** Compose a newly-created agent from the preset service owned by the root context. */
+export declare function mountAgentPreset(agentPresets: {
+    mount(agentCtx: Context, id: string): Promise<unknown> | unknown;
+}, agentCtx: Context, id: string): Promise<void>;
+export interface Config {
+    projectMappings: Array<{
+        projectPath: string;
+        localRepoPath: string;
+        reviewProfile: ReviewSkillProfile;
+    }>;
+    gitlabBaseUrl: string;
+    /**
+     * Fallback when Maestro Settings has no token; optional so a deployment that
+     * configures everything through Settings boots without env vars.
+     */
+    gitlabToken?: string;
+    botUsername: string;
+    /** Hard ceiling on one automated agent's turn. */
+    agentTimeoutMs: number;
+}
+export declare const DEFAULT_AGENT_TIMEOUT_MS: number;
+export declare const Config: z<Config>;
+export interface ReviewOutcome {
+    summary: string;
+    failures: string[];
+}
+/**
+ * Await an agent's turn with a hard ceiling. A hung automated agent would
+ * otherwise hold its session, worktree, and review key forever; the watchdog
+ * disposes the handle and rejects so the review is recorded as failed.
+ */
+export declare function whenIdleWithTimeout(handle: AgentHandle, timeoutMs: number): Promise<void>;
+export interface ReviewAndAuditDeps {
+    localRepoPath: string;
+    /** `keySuffix` isolates concurrent reviews of one MR (quick vs deep). */
+    ensureWorktree(localRepoPath: string, sourceBranch: string, projectId: number, mrIid: number, keySuffix?: string): Promise<string>;
+    removeWorktree(worktreePath: string): Promise<void>;
+    runReviewer(worktreePath: string, payload: ReviewRequest): Promise<ReviewOutcome>;
+    runAuditor(worktreePath: string, payload: ReviewRequest): Promise<string>;
+    postComment(body: string): Promise<void>;
+    replyToDiscussion(discussionId: string, body: string): Promise<void>;
+    writeFailedReport(mrIid: number, body: string): Promise<void>;
+}
+export interface DiffOnlyReviewDeps {
+    runReviewer(payload: ReviewRequest): Promise<ReviewOutcome>;
+    postComment(body: string): Promise<void>;
+    replyToDiscussion(discussionId: string, body: string): Promise<void>;
+    writeFailedReport(mrIid: number, body: string): Promise<void>;
+}
+export interface ReviewCommentDeps {
+    postComment(body: string): Promise<void>;
+    replyToDiscussion(discussionId: string, body: string): Promise<void>;
+    writeFailedReport(mrIid: number, body: string): Promise<void>;
+}
+export interface GitlabFindingPoster {
+    baseUrl: string;
+    token: string;
+    projectId: number;
+    mrIid: number;
+    fetcher?: typeof fetch;
+    /** Internal per-review cache: all positions must use one MR diff snapshot. */
+    snapshot?: Promise<GitlabDiffSnapshot>;
+}
+interface GitlabMrChange {
+    old_path: string;
+    new_path: string;
+    diff: string;
+    collapsed?: boolean;
+    too_large?: boolean;
+}
+interface GitlabDiffPosition {
+    oldLine?: number;
+    newLine?: number;
+}
+interface GitlabDiffSnapshot {
+    diffRefs: {
+        base_sha: string;
+        start_sha: string;
+        head_sha: string;
+    };
+    changes: GitlabMrChange[];
+}
+/** Map a new-side line number to its exact unified-diff position. */
+export declare function diffPositionForNewLine(diff: string, targetLine: number): GitlabDiffPosition | undefined;
+/**
+ * Publish agent findings from the orchestrator's own context. Agent tools are
+ * mounted inside a setup child fiber and are not guaranteed to remain
+ * executable through `handle.agent.ctx` after the agent turn ends.
+ */
+export declare function postReviewFindings(findings: ReviewFinding[], config: GitlabFindingPoster): Promise<void>;
+/**
+ * Stable 8-char hex suffix of the review key, so distinct concurrent reviews
+ * (quick + deep of one MR) never share one worktree directory.
+ */
+export declare function reviewKeyHash(payload: ReviewRequest): string;
+/** Full review + performance audit; resolves to the comment body that was posted. */
+export declare function runReviewAndAudit(payload: ReviewRequest, deps: ReviewAndAuditDeps): Promise<string>;
+/**
+ * Review the GitLab diff without a local checkout. This deliberately has no
+ * auditor or Magento profile: those require the mapped repository and its
+ * environment. It is only reached for an explicit mention, never assignment.
+ */
+/** Diff-only fallback review; resolves to the comment body that was posted. */
+export declare function runDiffOnlyReview(payload: ReviewRequest, deps: DiffOnlyReviewDeps): Promise<string>;
+/** Decline a Deep request that lacks the local mapping it requires. */
+export declare function declineUnmappedDeepReview(payload: ReviewRequest, deps: ReviewCommentDeps): Promise<void>;
+/**
+ * Keep a Govard audit worktree isolated from the developer's primary checkout.
+ * Without this local override, both checkouts inherit the same `project_name`
+ * and Govard may either reject the worktree or run commands in the wrong stack.
+ */
+export declare function govardWorktreeOverride(projectId: number, mrIid: number, keySuffix?: string): string;
+export declare function ensureWorktree(localRepoPath: string, sourceBranch: string, projectId: number, mrIid: number, keySuffix?: string): Promise<string>;
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=orchestrator.d.ts.map

package/lib/orchestrator.d.ts.map

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