@tiic-tech/openworkflow 0.1.1 → 0.1.2

package/dist/core/src/git/prReadySummary.d.ts

@@ -0,0 +1,16 @@
+export interface GeneratePrReadySummaryOptions {
+    root: string;
+    queuePath: string;
+    outputPath?: string;
+    dryRun?: boolean;
+}
+export interface GeneratePrReadySummaryResult {
+    ok: boolean;
+    dryRun: boolean;
+    queuePath: string;
+    outputPath: string;
+    content: string;
+    errors: string[];
+    warnings: string[];
+}
+export declare function generatePrReadySummary(options: GeneratePrReadySummaryOptions): Promise<GeneratePrReadySummaryResult>;

package/dist/core/src/git/prReadySummary.js

@@ -0,0 +1,144 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parseYaml } from "../contracts/yaml.js";
+import { readLocalGitEvidence } from "./localEvidenceReader.js";
+export async function generatePrReadySummary(options) {
+    const dryRun = options.dryRun !== false;
+    const queuePath = normalizeRepoPath(options.queuePath);
+    const defaultOutputPath = defaultSummaryPath(queuePath);
+    const outputPath = normalizeRepoPath(options.outputPath ?? defaultOutputPath);
+    const base = emptyResult(dryRun, queuePath, outputPath);
+    let queue;
+    try {
+        queue = asRecord(parseYaml(await readFile(join(options.root, queuePath), "utf8")));
+    }
+    catch (error) {
+        return { ...base, errors: [error instanceof Error ? error.message : String(error)] };
+    }
+    const changes = asArray(queue.changes).map((change) => asRecord(change));
+    const completed = changes.filter((change) => change.status === "done");
+    const remaining = changes.filter((change) => change.status !== "done");
+    const highRisk = changes.filter((change) => change.risk === "high");
+    const localEvidence = await readLocalGitEvidence(options.root, queue);
+    const validation = localEvidence.validationEvidence.map((item) => item.value);
+    const warnings = [
+        ...base.warnings,
+        ...localEvidence.warnings,
+        ...(remaining.length > 0 ? ["candidate queue is not fully complete; PR-ready summary is a review packet, not a merge signal"] : []),
+        ...(validation.length === 0 ? ["no validation evidence found in queue or completed candidates"] : []),
+    ];
+    const content = renderSummary({
+        planId: scalar(queue.plan_id, "unknown-plan"),
+        title: scalar(queue.title, "Untitled candidate queue"),
+        branchBoundary: scalar(asRecord(queue.queue_policy).branch_boundary, "not recorded"),
+        queuePath,
+        completed,
+        remaining,
+        highRisk,
+        commitEvidence: localEvidence.commitEvidence,
+        validation,
+        warnings,
+    });
+    if (!dryRun) {
+        await mkdir(dirname(join(options.root, outputPath)), { recursive: true });
+        await writeFile(join(options.root, outputPath), content, "utf8");
+    }
+    return { ...base, ok: true, content, warnings };
+}
+function renderSummary(input) {
+    return [
+        `# PR Ready Summary - ${input.planId}`,
+        "",
+        "This is a local review handoff artifact. It does not mean a remote PR was opened, edited, pushed, merged, or approved.",
+        "",
+        "## Feat",
+        "",
+        `- Plan id: \`${input.planId}\``,
+        `- Title: ${input.title}`,
+        `- Branch boundary: \`${input.branchBoundary}\``,
+        `- Source queue: \`${input.queuePath}\``,
+        "",
+        "## Completed Changes",
+        "",
+        ...renderCompleted(input.completed, input.commitEvidence),
+        "",
+        "## Deferred Or Blocked Changes",
+        "",
+        ...renderRemaining(input.remaining),
+        "",
+        "## High-Risk Decisions",
+        "",
+        ...renderHighRisk(input.highRisk),
+        "",
+        "## Validation",
+        "",
+        ...renderList(input.validation, "- No validation evidence found."),
+        "",
+        "## Review Notes",
+        "",
+        "- This artifact is local evidence only.",
+        "- Remote PR creation or mutation requires separate gh operation governance and explicit user approval.",
+        ...input.warnings.map((warning) => `- Warning: ${warning}`),
+        "",
+    ].join("\n");
+}
+function renderCompleted(changes, commitEvidence) {
+    if (changes.length === 0) {
+        return ["- No completed changes recorded."];
+    }
+    return changes.map((change) => {
+        const candidateId = scalar(change.id, "unknown");
+        const selectedChangeId = scalar(asRecord(change.selection).selected_change_id, "not recorded");
+        const commits = commitEvidence.filter((item) => item.candidate_id === candidateId).map(formatCommitEvidence);
+        const commitText = commits.length > 0 ? `; ${commits.join("; ")}` : "; commit: not recorded";
+        return `- \`${candidateId}\` ${scalar(change.title, "Untitled change")} (selected: \`${selectedChangeId}\`${commitText})`;
+    });
+}
+function formatCommitEvidence(item) {
+    const path = item.evidence_path ? `, evidence: ${item.evidence_path}` : "";
+    return `commit: ${item.hash}${path}`;
+}
+function renderRemaining(changes) {
+    if (changes.length === 0) {
+        return ["- None."];
+    }
+    return changes.map((change) => `- \`${scalar(change.id, "unknown")}\` status \`${scalar(change.status, "unknown")}\`: ${scalar(change.title, "Untitled change")}`);
+}
+function renderHighRisk(changes) {
+    if (changes.length === 0) {
+        return ["- No high-risk candidates recorded."];
+    }
+    return changes.map((change) => `- \`${scalar(change.id, "unknown")}\` status \`${scalar(change.status, "unknown")}\`: ${scalar(change.title, "Untitled high-risk change")}`);
+}
+function renderList(values, empty) {
+    return values.length > 0 ? values.map((value) => `- \`${value}\``) : [empty];
+}
+function defaultSummaryPath(queuePath) {
+    const segments = queuePath.split("/");
+    segments[segments.length - 1] = "PR_READY_SUMMARY.md";
+    return segments.join("/");
+}
+function emptyResult(dryRun, queuePath, outputPath) {
+    return {
+        ok: false,
+        dryRun,
+        queuePath,
+        outputPath,
+        content: "",
+        errors: [],
+        warnings: [],
+    };
+}
+function scalar(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function normalizeRepoPath(path) {
+    return path.replace(/\\/g, "/").replace(/^\.?\//, "").replace(/\/+$/g, "");
+}
+//# sourceMappingURL=prReadySummary.js.map

package/dist/core/src/git/prReadySummary.js.map

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

package/dist/core/src/git/remoteReadonlyPlanner.d.ts

@@ -0,0 +1,60 @@
+import { type BranchIdentityAssessment } from "./branchIdentity.js";
+import { type LocalGitCommitEvidence } from "./localEvidenceReader.js";
+import { type MergeReadinessCheckpoint } from "./mergeReadinessCheckpoint.js";
+export interface PlanRemoteReadonlyOptions {
+    root: string;
+    queuePath: string;
+    baseRef?: string;
+    targetRemote?: string;
+    targetBase?: string;
+    targetBranch?: string;
+    prSummaryPath?: string;
+}
+export interface PlanRemoteReadonlyResult {
+    ok: boolean;
+    mode: "remote-readonly-plan";
+    mutation_performed: false;
+    queuePath: string;
+    planId: string;
+    targetIdentity: {
+        remote: string;
+        remoteUrl: string | null;
+        base: string;
+        branch: string;
+        currentBranch: string | null;
+        branchBoundary: string | null;
+        branchMatchesCurrent: boolean | null;
+        branchOwnsPlan: boolean | null;
+        branchIdentity: BranchIdentityAssessment;
+    };
+    localState: {
+        head: string | null;
+        baseRef: string | null;
+        dirtyPaths: string[];
+        orderedCommits: Array<{
+            hash: string;
+            subject: string;
+        }>;
+        commitEvidence: LocalGitCommitEvidence[];
+        validationEvidence: string[];
+        simulatorEvidencePresent: boolean;
+        prSummaryPath: string;
+        prSummaryExists: boolean;
+    };
+    remoteState: {
+        branchHead: string | null;
+        baseHead: string | null;
+    };
+    prState: {
+        lookupAttempted: boolean;
+        available: boolean;
+        items: Array<Record<string, unknown>>;
+        warning: string | null;
+    };
+    mergeReadiness: MergeReadinessCheckpoint;
+    blockers: string[];
+    warnings: string[];
+    readOnlyPlan: string[];
+    rollbackPlan: string[];
+}
+export declare function planRemoteReadonly(options: PlanRemoteReadonlyOptions): Promise<PlanRemoteReadonlyResult>;

package/dist/core/src/git/remoteReadonlyPlanner.js

@@ -0,0 +1,223 @@
+import { execFile } from "node:child_process";
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { parseYaml } from "../contracts/yaml.js";
+import { assessBranchIdentity, branchIdentityExceptionFrom } from "./branchIdentity.js";
+import { readLocalGitEvidence } from "./localEvidenceReader.js";
+import { buildMergeReadinessCheckpoint } from "./mergeReadinessCheckpoint.js";
+const execFileAsync = promisify(execFile);
+export async function planRemoteReadonly(options) {
+    const queue = await loadQueue(options.root, options.queuePath);
+    const planId = stringValue(queue.plan_id) ?? "unknown-plan";
+    const queuePolicy = record(queue.queue_policy);
+    const branchBoundary = stringValue(queuePolicy.branch_boundary);
+    const currentBranch = await gitCaptureTrim(options.root, ["branch", "--show-current"]);
+    const branchIdentity = assessBranchIdentity(planId, branchBoundary, branchIdentityExceptionFrom(queuePolicy), "remote-plan");
+    const branchMatchesCurrent = branchBoundary ? currentBranch === branchBoundary : null;
+    const targetRemote = options.targetRemote ?? "origin";
+    const targetBase = options.targetBase ?? options.baseRef ?? "main";
+    const targetBranch = options.targetBranch ?? branchBoundary ?? currentBranch ?? "HEAD";
+    const baseRef = options.baseRef ?? targetBase;
+    const prSummaryPath = options.prSummaryPath ?? defaultPrSummaryPath(options.queuePath);
+    const remoteUrl = await gitCaptureTrim(options.root, ["remote", "get-url", targetRemote]);
+    const localHead = await gitCaptureTrim(options.root, ["rev-parse", "HEAD"]);
+    const dirtyPaths = await readDirtyPaths(options.root);
+    const orderedCommits = await readOrderedCommits(options.root, baseRef);
+    const localEvidence = await readLocalGitEvidence(options.root, queue);
+    const commitEvidence = localEvidence.commitEvidence;
+    const validationEvidence = localEvidence.validationEvidence.map((item) => item.value);
+    const simulatorEvidencePresent = hasSimulatorEvidence(queue);
+    const prSummaryExists = await exists(join(options.root, prSummaryPath));
+    const branchHead = parseLsRemoteHead(await gitCapture(options.root, ["ls-remote", "--heads", targetRemote, targetBranch]));
+    const baseHead = parseLsRemoteHead(await gitCapture(options.root, ["ls-remote", "--heads", targetRemote, targetBase]));
+    const prState = await readPrState(options.root, targetBranch, targetBase);
+    const mergeReadiness = await buildMergeReadinessCheckpoint({
+        root: options.root,
+        targetRemote,
+        targetBase,
+        targetBranch,
+        baseHead,
+        branchHead,
+        validationEvidence,
+    });
+    const blockers = [
+        ...(!branchBoundary ? ["queue_policy.branch_boundary is missing"] : []),
+        ...branchIdentity.errors,
+        ...(branchBoundary && currentBranch !== branchBoundary ? [`current branch ${currentBranch ?? "(detached)"} does not match branch boundary ${branchBoundary}`] : []),
+        ...(dirtyPaths.length > 0 ? ["working tree is not clean"] : []),
+        ...(!remoteUrl ? [`target remote is unknown: ${targetRemote}`] : []),
+        ...(!baseHead ? [`remote base head is unknown for ${targetRemote}/${targetBase}`] : []),
+        ...(orderedCommits.length === 0 && commitEvidence.length === 0 ? ["no ordered local commits or queue commit evidence available"] : []),
+        ...(!simulatorEvidencePresent ? ["simulator evidence is missing"] : []),
+        ...(!prSummaryExists ? [`PR-ready summary is missing: ${prSummaryPath}`] : []),
+        ...(validationEvidence.length === 0 ? ["validation evidence is missing"] : []),
+        ...mergeReadiness.stopReasons.filter((reason) => reason.includes("merge conflict checkpoint")),
+    ];
+    const warnings = [
+        ...(!branchHead ? [`remote branch head is absent or unreadable for ${targetRemote}/${targetBranch}`] : []),
+        ...branchIdentity.warnings,
+        ...localEvidence.warnings,
+        ...(prState.warning ? [prState.warning] : []),
+        "remote-readonly-plan is read-only and did not push, create PRs, edit PRs, merge, or mutate Issues",
+    ];
+    return {
+        ok: blockers.length === 0,
+        mode: "remote-readonly-plan",
+        mutation_performed: false,
+        queuePath: options.queuePath,
+        planId,
+        targetIdentity: {
+            remote: targetRemote,
+            remoteUrl,
+            base: targetBase,
+            branch: targetBranch,
+            currentBranch,
+            branchBoundary,
+            branchMatchesCurrent,
+            branchOwnsPlan: branchIdentity.owns_plan,
+            branchIdentity,
+        },
+        localState: {
+            head: localHead,
+            baseRef,
+            dirtyPaths,
+            orderedCommits,
+            commitEvidence,
+            validationEvidence,
+            simulatorEvidencePresent,
+            prSummaryPath,
+            prSummaryExists,
+        },
+        remoteState: {
+            branchHead,
+            baseHead,
+        },
+        prState,
+        mergeReadiness,
+        blockers,
+        warnings,
+        readOnlyPlan: [
+            "verify target remote, branch, and base identity",
+            "compare local HEAD, ordered commits, and queue commit evidence",
+            "compare remote branch head and target base head",
+            "compute read-only merge readiness checkpoint without running git merge",
+            "inspect existing draft PR metadata when gh is available",
+            "produce a push and draft PR operation preview for a later approved mutation candidate",
+            "stop before any git push, gh pr create, gh pr edit, merge, or Issue mutation",
+        ],
+        rollbackPlan: [
+            "for a later branch push: record previous remote ref and prefer revert PR recovery over force-push",
+            "for a later draft PR create: record PR URL and close guidance",
+            "for a later draft PR update: record previous managed-section digest and restore guidance",
+            "for merge or Issue mutation: no rollback is planned because those operations remain out of scope",
+        ],
+    };
+}
+async function loadQueue(root, queuePath) {
+    return record(parseYaml(await readFile(join(root, queuePath), "utf8")));
+}
+async function readOrderedCommits(root, baseRef) {
+    try {
+        const { stdout } = await execFileAsync("git", ["log", "--reverse", "--pretty=format:%H%x09%s", `${baseRef}..HEAD`], { cwd: root });
+        return stdout.split("\n").filter(Boolean).map((line) => {
+            const [hash, ...subjectParts] = line.split("\t");
+            return { hash: hash ?? "", subject: subjectParts.join("\t") };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function readDirtyPaths(root) {
+    const status = await gitCapture(root, ["status", "--porcelain"]);
+    return status.split("\n").map((line) => line.slice(3).trim()).filter(Boolean);
+}
+async function readPrState(root, head, base) {
+    try {
+        const { stdout } = await execFileAsync("gh", [
+            "pr",
+            "list",
+            "--head",
+            head,
+            "--base",
+            base,
+            "--state",
+            "all",
+            "--json",
+            "number,title,state,isDraft,url,headRefName,baseRefName,updatedAt",
+            "--limit",
+            "10",
+        ], { cwd: root });
+        return {
+            lookupAttempted: true,
+            available: true,
+            items: array(JSON.parse(stdout)).map(record),
+            warning: null,
+        };
+    }
+    catch {
+        return {
+            lookupAttempted: true,
+            available: false,
+            items: [],
+            warning: "gh PR metadata is unavailable; remote git refs were still read without mutation",
+        };
+    }
+}
+async function gitCaptureTrim(root, args) {
+    const output = await gitCapture(root, args);
+    if (!output.trim()) {
+        return null;
+    }
+    return output.trim().split("\n")[0] ?? null;
+}
+async function gitCapture(root, args) {
+    try {
+        const { stdout } = await execFileAsync("git", args, { cwd: root });
+        return stdout;
+    }
+    catch {
+        return "";
+    }
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseLsRemoteHead(output) {
+    const first = output.trim().split("\n").find(Boolean);
+    if (!first) {
+        return null;
+    }
+    return first.split(/\s+/)[0] ?? null;
+}
+function hasSimulatorEvidence(queue) {
+    return array(queue.changes).map(record).some((candidate) => {
+        const id = stringValue(candidate.id) ?? "";
+        const title = (stringValue(candidate.title) ?? "").toLowerCase();
+        const status = stringValue(candidate.status);
+        const completionEvidence = array(record(candidate.completion).evidence);
+        return status === "done" && completionEvidence.length > 0 && (id === "G017" || title.includes("simulator"));
+    });
+}
+function defaultPrSummaryPath(queuePath) {
+    const parts = queuePath.split("/");
+    parts[parts.length - 1] = "PR_READY_SUMMARY.md";
+    return parts.join("/");
+}
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function array(value) {
+    return Array.isArray(value) ? value : [];
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=remoteReadonlyPlanner.js.map

package/dist/core/src/git/remoteReadonlyPlanner.js.map

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

package/dist/core/src/onboarding/agentsGuide.d.ts

@@ -0,0 +1,32 @@
+import type { CleanResult } from "../workflow/cleanOpenWorkflow.js";
+export declare const AGENTS_GUIDE_PATH = "AGENTS.md";
+export declare const AGENTS_GUIDE_TEMPLATE_ID = "openworkflow.agents-guide.v1";
+export declare const AGENTS_GUIDE_BEGIN = "<!-- BEGIN OPENWORKFLOW AGENT GUIDE generated-by: openworkflow; template-id: openworkflow.agents-guide.v1 -->";
+export declare const AGENTS_GUIDE_END = "<!-- END OPENWORKFLOW AGENT GUIDE -->";
+export interface AgentsGuideSyncResult {
+    path: string;
+    action: "created" | "appended" | "updated" | "unchanged";
+}
+export interface AgentsGuideDoctorResult {
+    ok: boolean;
+    warnings: string[];
+    errors: string[];
+}
+export declare function renderAgentsGuide(): string;
+export declare function syncAgentsGuide(root: string): Promise<AgentsGuideSyncResult>;
+export declare function doctorAgentsGuide(root: string): Promise<AgentsGuideDoctorResult>;
+export declare function cleanAgentsGuide(options: {
+    root: string;
+    yes: boolean;
+}): Promise<CleanResult>;
+export declare function hasAgentsGuide(content: string): boolean;
+export declare function isAgentsGuideCurrent(content: string): boolean;
+export declare function upsertAgentsGuide(existing: string | null): {
+    content: string;
+    changed: boolean;
+    action: "created" | "appended" | "updated" | "unchanged";
+};
+export declare function removeAgentsGuide(existing: string): {
+    content: string;
+    changed: boolean;
+};