@aipper/aiws 0.0.28 → 0.0.30

package/dist/commands/change-evidence-command.js

@@ -0,0 +1,213 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { buildDeliverySummary, collectCollaborationArtifacts, findLatestFileByMtime, formatDeclaredValues, mergeDeclaredValues, relFromRoot, upsertIdLine, upsertProposalEvidencePath, } from "./change-evidence.js";
+import { TMP_REVIEW_FALLBACKS, tmpReviewFallbackPath } from "./change-review-gates.js";
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   changeDir: string,
+ *   proposalText: string,
+ *   options: { noValidate: boolean, allowFail: boolean }
+ * }} input
+ * @param {{
+ *   appendMetricsEvent: (gitRoot: string, changeId: string, type: string, payload: any) => Promise<void>,
+ *   computeChangeStatus: (gitRoot: string, changeId: string) => Promise<any>,
+ *   currentBranch: (gitRoot: string) => Promise<string>,
+ *   ensureDir: (path: string) => Promise<void>,
+ *   extractId: (label: string, text: string) => string,
+ *   nowIsoUtc: () => string,
+ *   nowStampUtc: () => string,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   planVerifyHint: (changeId: string) => string,
+ *   readText: (path: string) => Promise<string>,
+ *   splitDeclaredValues: (s: string) => string[],
+ *   validateChangeArtifacts: (gitRoot: string, changeId: string, options: any) => Promise<any>,
+ *   writeText: (path: string, content: string) => Promise<void>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function runChangeEvidenceWorkflow(input, deps) {
+    const { gitRoot, changeId, changeDir, proposalText, options } = input;
+    const planDecl = deps.extractId("Plan_File", proposalText) || deps.extractId("Plan file", proposalText);
+    const planFiles = deps.splitDeclaredValues(planDecl).map((item) => String(item || "").replace(/^\.\//, ""));
+    const planRel = planFiles.length === 1 ? planFiles[0] : "";
+    const planAbs = planRel ? path.join(gitRoot, planRel) : "";
+    const planText = planAbs && (await deps.pathExists(planAbs)) ? await deps.readText(planAbs) : "";
+    const now = deps.nowStampUtc();
+    const evidenceDir = path.join(changeDir, "evidence");
+    const reviewDir = path.join(changeDir, "review");
+    const analysisDir = path.join(changeDir, "analysis");
+    const patchesDir = path.join(changeDir, "patches");
+    await deps.ensureDir(evidenceDir);
+    await deps.ensureDir(reviewDir);
+    await deps.ensureDir(analysisDir);
+    await deps.ensureDir(patchesDir);
+    /** @type {string[]} */
+    const created = [];
+    const branch = await deps.currentBranch(gitRoot);
+    const status = await deps.computeChangeStatus(gitRoot, changeId);
+    const statusPath = path.join(evidenceDir, `change-status-${now}.json`);
+    await deps.writeText(statusPath, JSON.stringify({
+        generated_at: deps.nowIsoUtc(),
+        ws_root: gitRoot,
+        change_id: changeId,
+        branch: branch || "",
+        phase: status.phase,
+        tasks: status.tasks,
+        bindings: status.bindings,
+        truth: {
+            baseline: { label: status.baselineLabel, at: status.baselineAt },
+            drift_files: status.driftFiles,
+        },
+        evidence: status.evidence?.counts || null,
+        collaboration: status.collaboration?.counts || null,
+        note: "aiws change evidence status snapshot; does not contain secrets.",
+    }, null, 2) + "\n");
+    created.push(relFromRoot(gitRoot, statusPath));
+    /** @type {any | null} */
+    let validateRes = null;
+    let validateFailed = false;
+    let validatePathForError = "";
+    if (!options.noValidate) {
+        validateRes = await deps.validateChangeArtifacts(gitRoot, changeId, { strict: true, allowTruthDrift: false });
+        const validatePath = path.join(evidenceDir, `change-validate-strict-${now}.json`);
+        await deps.writeText(validatePath, JSON.stringify(validateRes, null, 2) + "\n");
+        created.push(relFromRoot(gitRoot, validatePath));
+        validateFailed = validateRes.ok !== true;
+        validatePathForError = validatePath;
+    }
+    const validateStampDir = path.join(gitRoot, ".aiws", "tmp", "aiws-validate");
+    const latestValidateStamp = await findLatestFileByMtime(validateStampDir, (name) => name.endsWith(".json"));
+    if (latestValidateStamp) {
+        const dest = path.join(evidenceDir, `aiws-validate-stamp-${now}.json`);
+        await fs.copyFile(latestValidateStamp, dest);
+        created.push(relFromRoot(gitRoot, dest));
+    }
+    const syncStampDir = path.join(gitRoot, ".aiws", "tmp", "change-sync");
+    const latestSyncStamp = await findLatestFileByMtime(syncStampDir, (name) => name.endsWith(`-${changeId}.json`));
+    if (latestSyncStamp) {
+        const dest = path.join(evidenceDir, `change-sync-stamp-${now}.json`);
+        await fs.copyFile(latestSyncStamp, dest);
+        created.push(relFromRoot(gitRoot, dest));
+    }
+    for (const { fileName, persistentKind } of TMP_REVIEW_FALLBACKS) {
+        const src = tmpReviewFallbackPath(gitRoot, fileName);
+        if (!(await deps.pathExists(src)))
+            continue;
+        const dest = persistentKind === "evidence" ? path.join(evidenceDir, fileName) : path.join(reviewDir, fileName);
+        if (!(await deps.pathExists(dest))) {
+            await fs.copyFile(src, dest);
+        }
+        const rel = relFromRoot(gitRoot, dest);
+        if (!created.includes(rel))
+            created.push(rel);
+    }
+    if (await deps.pathExists(reviewDir)) {
+        try {
+            const reviewEntries = await fs.readdir(reviewDir, { withFileTypes: true });
+            for (const entry of reviewEntries) {
+                if (!entry.isFile())
+                    continue;
+                if (entry.name === "codex-review.md")
+                    continue;
+                if (!entry.name.endsWith(".md"))
+                    continue;
+                const rel = relFromRoot(gitRoot, path.join(reviewDir, entry.name));
+                if (!created.includes(rel))
+                    created.push(rel);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const collaboration = await collectCollaborationArtifacts(gitRoot, changeDir);
+    const collaborationPath = path.join(evidenceDir, `collaboration-summary-${now}.json`);
+    await deps.writeText(collaborationPath, JSON.stringify({
+        generated_at: deps.nowIsoUtc(),
+        ws_root: gitRoot,
+        change_id: changeId,
+        counts: collaboration.counts,
+        dirs: collaboration.dirs,
+        note: "aiws collaboration summary; patch files are drafts and must be reviewed before apply.",
+    }, null, 2) + "\n");
+    created.push(relFromRoot(gitRoot, collaborationPath));
+    const summaryAbs = path.join(evidenceDir, `delivery-summary-${now}.md`);
+    await deps.writeText(summaryAbs, buildDeliverySummary({
+        gitRoot,
+        changeId,
+        branch: branch || "",
+        status,
+        collaboration,
+        created,
+        validateRes,
+        validateFailed,
+    }));
+    created.push(relFromRoot(gitRoot, summaryAbs));
+    const declaredEvidence = deps.extractId("Evidence_Path", proposalText) || deps.extractId("Evidence_Path(s)", proposalText);
+    const existingProposalEvidence = deps.splitDeclaredValues(declaredEvidence).map((item) => String(item || "").replace(/^\.\//, ""));
+    const mergedEvidence = mergeDeclaredValues(existingProposalEvidence, created);
+    const mergedEvidenceText = formatDeclaredValues(mergedEvidence);
+    const updatedProposal = upsertProposalEvidencePath(proposalText, mergedEvidenceText);
+    if (updatedProposal.changed) {
+        await deps.writeText(path.join(changeDir, "proposal.md"), updatedProposal.text);
+    }
+    let planUpdated = false;
+    if (planAbs && planText) {
+        const existingPlanEvidence = deps
+            .splitDeclaredValues(deps.extractId("Evidence_Path", planText) || deps.extractId("Evidence_Path(s)", planText))
+            .map((item) => String(item || "").replace(/^\.\//, ""));
+        const mergedPlanEvidence = mergeDeclaredValues(existingPlanEvidence, mergedEvidence);
+        const mergedPlanEvidenceText = formatDeclaredValues(mergedPlanEvidence);
+        const updatedPlan = upsertIdLine(planText, ["Evidence_Path", "Evidence_Path(s)"], mergedPlanEvidenceText, { insertAfterLabels: ["Plan_File", "Contract_Row"] });
+        if (updatedPlan.changed) {
+            await deps.writeText(planAbs, updatedPlan.text);
+            planUpdated = true;
+        }
+    }
+    await deps.appendMetricsEvent(gitRoot, changeId, "evidence", {
+        generated_at: deps.nowIsoUtc(),
+        created: created.length,
+        strict_validate: options.noValidate ? "skipped" : validateRes && validateRes.ok === true ? "ok" : "failed",
+        allow_fail: options.allowFail === true,
+    });
+    /** @type {string[]} */
+    const outputLines = [];
+    outputLines.push(`✓ aiws change evidence: ${changeId}`);
+    outputLines.push(`dir: ${path.relative(gitRoot, changeDir)}`);
+    if (planRel)
+        outputLines.push(`Plan_File: ${planRel}`);
+    outputLines.push("created:");
+    if (created.length > 0) {
+        for (const item of created)
+            outputLines.push(`- ${item}`);
+    }
+    else {
+        outputLines.push("- (none)");
+    }
+    outputLines.push("updated:");
+    outputLines.push(`- ${path.relative(gitRoot, path.join(changeDir, "proposal.md"))} (Evidence_Path)`);
+    if (planRel && planText && planUpdated)
+        outputLines.push(`- ${planRel} (Evidence_Path)`);
+    else if (planRel && planText)
+        outputLines.push(`- ${planRel} (Evidence_Path)`);
+    outputLines.push("");
+    outputLines.push("next:");
+    outputLines.push(`- ${deps.planVerifyHint(changeId)}`);
+    if (validateFailed)
+        outputLines.push("- fix validation errors, then re-run evidence (or run with --allow-fail to proceed)");
+    else
+        outputLines.push(`- verify evidence gate: \`aiws change validate ${changeId} --strict --check-evidence\``);
+    let errorToThrow = null;
+    if (validateFailed && !options.allowFail) {
+        const details = (validateRes && validateRes.raw ? String(validateRes.raw) : "").trim() || "Validation failed (see evidence JSON for details).";
+        const hint = validatePathForError ? `\n\nevidence:\n- ${path.relative(gitRoot, validatePathForError)}` : "";
+        errorToThrow = new deps.UserError("Failed to generate evidence due to strict validation errors.", { details: `${details}${hint}` });
+    }
+    return {
+        output: outputLines.join("\n") + "\n",
+        errorToThrow,
+    };
+}
+//# sourceMappingURL=change-evidence-command.js.map

package/dist/commands/change-evidence-command.js.map

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

package/dist/commands/change-evidence-entry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   options: { noValidate: boolean, allowFail: boolean }
+ * }} input
+ * @param {{
+ *   changeDirAbs: (gitRoot: string, changeId: string) => string,
+ *   fileState: (changeDir: string, rel: string) => Promise<any>,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   runChangeEvidenceWorkflow: (input: any, deps: any) => Promise<{ output: string, errorToThrow: any }>,
+ *   workflowDeps: Record<string, any>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export declare function runChangeEvidenceCommand(input: any, deps: any): Promise<any>;

package/dist/commands/change-evidence-entry.js

@@ -0,0 +1,35 @@
+import path from "node:path";
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   options: { noValidate: boolean, allowFail: boolean }
+ * }} input
+ * @param {{
+ *   changeDirAbs: (gitRoot: string, changeId: string) => string,
+ *   fileState: (changeDir: string, rel: string) => Promise<any>,
+ *   pathExists: (path: string) => Promise<boolean>,
+ *   runChangeEvidenceWorkflow: (input: any, deps: any) => Promise<{ output: string, errorToThrow: any }>,
+ *   workflowDeps: Record<string, any>,
+ *   UserError: typeof import("../errors.js").UserError
+ * }} deps
+ */
+export async function runChangeEvidenceCommand(input, deps) {
+    const { gitRoot, changeId, options } = input;
+    const changeDir = deps.changeDirAbs(gitRoot, changeId);
+    if (!(await deps.pathExists(changeDir))) {
+        throw new deps.UserError(`Missing change dir: ${path.relative(gitRoot, changeDir)}`);
+    }
+    const proposal = await deps.fileState(changeDir, "proposal.md");
+    if (proposal.state !== "ok") {
+        throw new deps.UserError("proposal.md is required for evidence generation.", { details: path.relative(gitRoot, proposal.abs) });
+    }
+    return deps.runChangeEvidenceWorkflow({
+        gitRoot,
+        changeId,
+        changeDir,
+        proposalText: proposal.text,
+        options,
+    }, deps.workflowDeps);
+}
+//# sourceMappingURL=change-evidence-entry.js.map

package/dist/commands/change-evidence-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-evidence-entry.js","sourceRoot":"","sources":["../../src/commands/change-evidence-entry.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,KAAU,EAAE,IAAS;IAClE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,uBAAuB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAChE,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,kDAAkD,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClI,CAAC;IAED,OAAO,IAAI,CAAC,yBAAyB,CACnC;QACE,OAAO;QACP,QAAQ;QACR,SAAS;QACT,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,OAAO;KACR,EACD,IAAI,CAAC,YAAY,CAClB,CAAC;AACJ,CAAC"}

package/dist/commands/change-evidence.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @param {string} gitRoot
+ * @param {string} absPath
+ */
+export declare function relFromRoot(gitRoot: string, absPath: string): string;
+/**
+ * @param {string} gitRoot
+ * @param {string} changeDir
+ */
+export declare function collectCollaborationArtifacts(gitRoot: string, changeDir: string): Promise<{
+    dirs: Record<string, {
+        label: string;
+        dir: string;
+        exists: boolean;
+        count: number;
+        files: string[];
+        truncated: boolean;
+    }>;
+    counts: Record<string, number>;
+}>;
+/**
+ * Evidence_Path is user-declared; we treat it as best-effort hints, not hard gates.
+ *
+ * @param {string} gitRoot
+ * @param {string} changeId
+ * @param {string[]} evidencePaths
+ * @returns {Promise<{
+ *   entries: Array<{rel: string, abs: string, exists: boolean, kind: string, isAbsolute: boolean}>,
+ *   counts: { total: number, exists: number, missing: number, tmp: number, persistent: number, other: number, absolute: number },
+ *   missing: string[]
+ * }>}
+ */
+export declare function analyzeEvidencePaths(gitRoot: string, changeId: string, evidencePaths: string[]): Promise<{
+    entries: {
+        rel: string;
+        abs: string;
+        exists: boolean;
+        kind: string;
+        isAbsolute: boolean;
+    }[];
+    counts: {
+        total: number;
+        exists: number;
+        missing: number;
+        tmp: number;
+        persistent: number;
+        other: number;
+        absolute: number;
+    };
+    missing: string[];
+}>;
+/**
+ * @param {string[]} a
+ * @param {string[]} b
+ */
+export declare function mergeDeclaredValues(a: string[], b: string[]): string[];
+/**
+ * @param {string[]} values
+ */
+export declare function formatDeclaredValues(values: string[]): string;
+/**
+ * Replace or insert a simple "ID: value" style line in Markdown.
+ *
+ * @param {string} text
+ * @param {string[]} labelCandidates
+ * @param {string} value
+ * @param {{ insertAfterLabels?: string[] }} options
+ */
+export declare function upsertIdLine(text: string, labelCandidates: string[], value: string, options: any): {
+    ok: boolean;
+    changed: boolean;
+    text: string;
+    mode: string;
+    label: string;
+};
+/**
+ * Special-case insertion for proposal.md template style.
+ *
+ * @param {string} proposalText
+ * @param {string} value
+ */
+export declare function upsertProposalEvidencePath(proposalText: string, value: string): {
+    changed: boolean;
+    text: string;
+    mode: string;
+};
+/**
+ * @param {string} changeId
+ */
+export declare function planVerifyHint(changeId: string): string;
+/**
+ * @param {string} absDir
+ * @param {(fileName: string) => boolean} predicate
+ */
+export declare function findLatestFileByMtime(absDir: string, predicate: (fileName: string) => boolean): Promise<string>;
+/**
+ * @param {{
+ *   gitRoot: string,
+ *   changeId: string,
+ *   branch: string,
+ *   status: any,
+ *   collaboration: any,
+ *   created: string[],
+ *   validateRes: any,
+ *   validateFailed: boolean
+ * }} options
+ */
+export declare function buildDeliverySummary(options: any): string;