@captain_z/zsk 1.7.0 → 1.8.2

package/dist/core/prepare-lifecycle.js

@@ -0,0 +1,302 @@
+import { createHash } from "node:crypto";
+import { access, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import YAML from "yaml";
+import { flattenProjectSources, resolveSourceSnapshot } from "./config.js";
+import { hasRemoteOriginLocator, inferSourceOrigin } from "./origin-detection.js";
+import { draftProjectConfig } from "./source-draft.js";
+import { getWorkspacePath } from "./workspace-layout.js";
+export async function buildPrepareArtifactBundle(target, config, runId = createPrepareRunId()) {
+    const draft = await draftProjectConfig(target);
+    const generatedAt = new Date().toISOString();
+    const inventory = await buildRepoInventory(target, draft.candidates, generatedAt);
+    const acquisitionPlan = await buildAcquisitionPlan(target, config, draft.candidates, generatedAt);
+    const artifacts = resolvePrepareArtifacts(target, config, runId);
+    return {
+        inventory,
+        draftContent: `${YAML.stringify(draft.config)}\n`,
+        acquisitionPlan,
+        blockedSources: renderBlockedSources(acquisitionPlan),
+        correspondenceQuestions: renderCorrespondenceQuestions(acquisitionPlan),
+        artifacts,
+    };
+}
+export async function writePrepareArtifactBundle(bundle) {
+    const { artifacts } = bundle;
+    await mkdir(artifacts.dir, { recursive: true });
+    await writeFile(artifacts.inventoryPath, `${JSON.stringify(bundle.inventory, null, 2)}\n`, "utf8");
+    await writeFile(artifacts.draftPath, bundle.draftContent, "utf8");
+    await writeFile(artifacts.acquisitionPlanPath, `${JSON.stringify(bundle.acquisitionPlan, null, 2)}\n`, "utf8");
+    await writeFile(artifacts.blockedSourcesPath, bundle.blockedSources, "utf8");
+    await writeFile(artifacts.correspondenceQuestionsPath, bundle.correspondenceQuestions, "utf8");
+}
+export function resolvePrepareArtifacts(target, config, runId) {
+    const root = resolve(target, getWorkspacePath(config, "evidenceRoot"), "prepare", runId);
+    return {
+        runId,
+        dir: root,
+        inventoryPath: join(root, "repo-inventory.json"),
+        draftPath: join(root, "config-draft.yaml"),
+        acquisitionPlanPath: join(root, "acquisition-plan.json"),
+        blockedSourcesPath: join(root, "blocked-sources.md"),
+        correspondenceQuestionsPath: join(root, "correspondence-questions.md"),
+    };
+}
+export function createPrepareRunId(now = new Date()) {
+    return now.toISOString().replace(/[:.]/g, "-");
+}
+async function buildRepoInventory(target, candidates, generatedAt) {
+    const records = await Promise.all(candidates.map(async (candidate) => ({
+        ...candidate,
+        ...(await describeFile(resolve(target, candidate.originPath))),
+    })));
+    return {
+        version: 1,
+        generatedAt,
+        records,
+    };
+}
+async function buildAcquisitionPlan(target, config, candidates, generatedAt) {
+    const records = [];
+    const configured = flattenProjectSources(config.sources);
+    const matched = new Set();
+    for (const entry of configured) {
+        const record = await describeConfiguredSource(target, config, entry);
+        records.push(record);
+        if (record.originRef)
+            matched.add(record.originRef);
+        if (record.snapshot)
+            matched.add(record.snapshot);
+    }
+    for (const candidate of candidates) {
+        if (matched.has(candidate.originPath) || matched.has(candidate.snapshot))
+            continue;
+        const file = resolve(target, candidate.originPath);
+        const exists = await pathExists(file);
+        records.push({
+            sourceKey: ["prepare", candidate.lane, candidate.sourceKey].join("-"),
+            provider: candidate.sourceKey,
+            sourcePath: join("prepare", candidate.lane, candidate.sourceKey),
+            rawLane: candidate.lane,
+            sourceType: candidate.sourceType,
+            originKind: "local",
+            originRef: candidate.originPath,
+            snapshot: candidate.snapshot,
+            snapshotExists: await pathExists(resolve(target, candidate.snapshot)),
+            status: candidate.confidence === "confirmed" && exists ? "ready" : exists ? "needs-confirmation" : "source-gap",
+            reason: !exists
+                ? "drafted repository source no longer exists at the detected local path"
+                : candidate.confidence === "confirmed"
+                    ? "discovered repository source can be drafted into grouped prepare config"
+                    : "scanner confidence is probable; confirm the grouped prepare lane before promoting this draft",
+            source: "draft",
+        });
+    }
+    records.sort((a, b) => `${a.source}:${a.sourcePath}:${a.provider}`.localeCompare(`${b.source}:${b.sourcePath}:${b.provider}`));
+    return {
+        version: 1,
+        generatedAt,
+        records,
+    };
+}
+async function describeConfiguredSource(target, config, entry) {
+    const source = entry.source;
+    const origin = inferSourceOrigin(source);
+    const snapshot = resolveSourceSnapshot(config, entry);
+    const snapshotPath = resolve(target, snapshot);
+    const snapshotExists = await pathExists(snapshotPath);
+    const { status, reason } = await classifyConfiguredSource(target, source, snapshotPath, snapshotExists);
+    return {
+        sourceKey: entry.id,
+        provider: entry.provider,
+        sourcePath: entry.path,
+        rawLane: entry.rawLane,
+        sourceType: source.type ?? source.kind,
+        originKind: origin.kind,
+        originProvider: origin.provider,
+        originRef: origin.ref,
+        snapshot,
+        snapshotExists,
+        status,
+        reason,
+        source: "config",
+    };
+}
+async function classifyConfiguredSource(target, source, snapshotPath, snapshotExists) {
+    const origin = inferSourceOrigin(source);
+    const originKind = origin.kind;
+    const localOriginPath = resolveLocalOriginPath(target, source);
+    if (localOriginPath) {
+        const originInfo = await safeStat(localOriginPath);
+        if (!originInfo) {
+            return {
+                status: "source-gap",
+                reason: "configured local origin path does not exist",
+            };
+        }
+        if (snapshotPath) {
+            const snapshotInfo = await safeStat(snapshotPath);
+            if (snapshotInfo && originInfo.mtimeMs > snapshotInfo.mtimeMs) {
+                return {
+                    status: "stale",
+                    reason: "materialized snapshot is older than the local origin source",
+                };
+            }
+        }
+        return {
+            status: "ready",
+            reason: "configured local origin is available for read-only prepare acquisition",
+        };
+    }
+    if (snapshotExists) {
+        return {
+            status: "ready",
+            reason: "materialized snapshot already exists for this source",
+        };
+    }
+    if (isAuthBlockedOriginKind(originKind)) {
+        return {
+            status: "blocked-auth",
+            reason: `detected ${originKind} origin from config; acquisition requires a confirmed adapter/auth contract`,
+        };
+    }
+    if (needsAcquisitionConfirmation(source)) {
+        return {
+            status: "needs-confirmation",
+            reason: originKind === "repository"
+                ? "detected repository origin from config; confirm clone/fetch policy and credentials before acquisition"
+                : "detected remote or provider-managed origin from config; confirm acquisition method before prepare can acquire it",
+        };
+    }
+    if (originKind && !isSupportedReadOnlyOriginKind(originKind)) {
+        return {
+            status: "needs-confirmation",
+            reason: "origin kind is project-specific; confirm the prepare acquisition method before treating it as authoritative",
+        };
+    }
+    return {
+        status: "source-gap",
+        reason: "source needs a local path, materialized snapshot, or supported provider adapter",
+    };
+}
+function resolveLocalOriginPath(target, source) {
+    const origin = source.origin;
+    const kind = origin?.kind ?? source.kind;
+    const path = origin?.path ?? source.path;
+    if (!path)
+        return null;
+    if (kind === "local" || kind === "openapi" || !kind)
+        return resolve(target, path);
+    if (origin && !hasRemoteOriginLocator(source))
+        return resolve(target, path);
+    return null;
+}
+function needsAcquisitionConfirmation(source) {
+    const origin = inferSourceOrigin(source);
+    return origin.remote || origin.method === "provider";
+}
+function isAuthBlockedOriginKind(kind) {
+    return kind ? ["confluence", "jira"].includes(kind) : false;
+}
+function isSupportedReadOnlyOriginKind(kind) {
+    return ["local", "openapi", "manual", "script", "skill"].includes(kind);
+}
+function renderBlockedSources(plan) {
+    const blocked = plan.records.filter((record) => record.status !== "ready");
+    const lines = [
+        "# Blocked Sources",
+        "",
+        blocked.length === 0
+            ? "No blocked prepare sources."
+            : "Sources that cannot proceed through the read-only prepare lifecycle without follow-up:",
+        "",
+    ];
+    if (blocked.length === 0)
+        return `${lines.join("\n")}\n`;
+    for (const record of blocked) {
+        lines.push(`- \`${record.sourcePath}\` [${record.status}]`);
+        lines.push(`  - provider: \`${record.provider}\``);
+        if (record.originKind)
+            lines.push(`  - origin: \`${record.originKind}\`${record.originRef ? ` -> \`${record.originRef}\`` : ""}`);
+        if (record.originProvider && record.originProvider !== record.originKind)
+            lines.push(`  - detected platform: \`${record.originProvider}\``);
+        if (record.snapshot)
+            lines.push(`  - snapshot: \`${record.snapshot}\``);
+        lines.push(`  - reason: ${record.reason}`);
+    }
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+function renderCorrespondenceQuestions(plan) {
+    const questions = [];
+    for (const record of plan.records) {
+        if (record.status === "needs-confirmation") {
+            if (record.source === "draft") {
+                questions.push(`- Confirm the prepare lane and source mapping for \`${record.sourcePath}\` before promoting \`${record.originRef}\` into \`.zsk/config.yaml\`.`);
+            }
+            else {
+                questions.push(`- Confirm the acquisition method and authority for \`${record.sourcePath}\` before treating \`${record.originRef ?? record.originKind ?? record.provider}\` as a prepare source.`);
+            }
+            continue;
+        }
+        if (record.source === "draft") {
+            questions.push(`- Confirm whether drafted source \`${record.originRef}\` should be promoted into \`.zsk/config.yaml\` as \`${record.sourcePath}\`.`);
+            continue;
+        }
+        if (record.status === "source-gap") {
+            questions.push(`- Provide or correct the local origin/snapshot for \`${record.sourcePath}\` (${record.provider}).`);
+            continue;
+        }
+        if (record.status === "blocked-auth") {
+            questions.push(`- Define the auth/adapter contract for \`${record.sourcePath}\` before enabling acquisition from \`${record.originKind}\`.`);
+            continue;
+        }
+        if (record.status === "unsupported-provider") {
+            questions.push(`- Decide whether to add a provider adapter or require a materialized snapshot for \`${record.sourcePath}\`.`);
+            continue;
+        }
+        if (record.status === "stale") {
+            questions.push(`- Refresh the snapshot for \`${record.sourcePath}\` or explicitly accept the current divergence from its local origin.`);
+        }
+    }
+    const lines = [
+        "# Correspondence Questions",
+        "",
+        questions.length === 0 ? "No correspondence questions." : questions.join("\n"),
+        "",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+async function describeFile(path) {
+    const info = await safeStat(path);
+    if (!info) {
+        return { exists: false, size: null, hash: null };
+    }
+    return {
+        exists: true,
+        size: Number(info.size),
+        hash: info.isFile() ? await sha256(path) : null,
+    };
+}
+async function safeStat(path) {
+    try {
+        return await stat(path);
+    }
+    catch {
+        return null;
+    }
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function sha256(path) {
+    const content = await readFile(path);
+    return createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=prepare-lifecycle.js.map

package/dist/core/prepare-lifecycle.js.map

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

package/dist/core/prepare-sync.d.ts

@@ -0,0 +1,82 @@
+import { type ProjectConfig } from "./config.js";
+export type PrepareSyncOptions = {
+    source?: string;
+    all?: boolean;
+    allowNetwork?: boolean;
+    authState?: string;
+    authProfile?: string;
+    browser?: boolean;
+    dryRun?: boolean;
+    runId?: string;
+};
+export type PrepareSyncStatus = "materialized" | "metadata-only" | "blocked-auth" | "source-gap" | "skipped" | "failed";
+export type PrepareSyncResult = {
+    envelopeVersion?: 1;
+    sourceKey: string;
+    sourcePath: string;
+    rawLane?: string;
+    provider?: string;
+    adapter?: string;
+    strategy: string;
+    status: PrepareSyncStatus;
+    origin?: string;
+    resolvedOrigin?: string;
+    contentType?: string;
+    snapshot?: string;
+    snapshotHash?: string;
+    previousSnapshotHash?: string;
+    metadata?: Record<string, unknown>;
+    changed: boolean;
+    reason: string;
+    validation: Record<string, "pass" | "fail" | "skipped">;
+};
+export type PrepareSyncArtifacts = {
+    runId: string;
+    dir: string;
+    adapterResultsDir: string;
+    authCheckPath: string;
+    downstreamImpactPath: string;
+    authScriptPath: string;
+    authStatePath: string;
+    migrationPlanPath: string;
+};
+export type PrepareSyncBundle = {
+    artifacts: PrepareSyncArtifacts;
+    results: PrepareSyncResult[];
+    downstreamImpact: string;
+};
+export type PrepareAuthCheckStatus = "ready" | "reachable" | "missing-auth" | "blocked-auth" | "source-gap" | "failed";
+export type PrepareAuthCheckResult = {
+    sourceKey: string;
+    sourcePath: string;
+    rawLane?: string;
+    provider?: string;
+    origin?: string;
+    method: string;
+    status: PrepareAuthCheckStatus;
+    authSources: string[];
+    directAuthAvailable: boolean;
+    networkAttempted: boolean;
+    httpStatus?: number;
+    contentType?: string;
+    reason: string;
+    validation: Record<string, "pass" | "fail" | "skipped">;
+};
+export type PrepareAuthCheckBundle = {
+    artifacts: PrepareSyncArtifacts;
+    results: PrepareAuthCheckResult[];
+};
+export declare function resolvePrepareSyncArtifacts(target: string, config: ProjectConfig, runId: string): PrepareSyncArtifacts;
+export declare function syncPrepareSources(target: string, config: ProjectConfig, opts?: PrepareSyncOptions): Promise<PrepareSyncBundle>;
+export declare function writeAuthLoginHelper(target: string, config: ProjectConfig, opts?: {
+    url?: string;
+    out?: string;
+    profile?: string;
+    runId?: string;
+}): Promise<PrepareSyncArtifacts>;
+export declare function checkPrepareAuth(target: string, config: ProjectConfig, opts?: PrepareSyncOptions): Promise<PrepareAuthCheckBundle>;
+export declare function buildRawMigrationPlan(target: string, config: ProjectConfig, runId?: string): Promise<{
+    artifacts: PrepareSyncArtifacts;
+    content: string;
+}>;
+export declare function createSyncRunId(now?: Date): string;