@captain_z/zsk 1.8.7 → 1.8.8

package/dist/core/prepare-readiness.js

@@ -0,0 +1,268 @@
+import { escapeTable, safeFileName } from "./prepare-utils.js";
+export const PREPARE_RESOURCE_CATEGORIES = [
+    "repo-context",
+    "docs",
+    "decision-records",
+    "issue-tracker",
+    "external-docs",
+];
+export const PREPARE_CONSUMER_REQUIREMENTS = {
+    proposal: ["docs", "external-docs", "issue-tracker"],
+    spec: ["docs", "external-docs", "decision-records", "issue-tracker"],
+    design: ["repo-context", "docs", "decision-records", "external-docs"],
+    coding: ["repo-context", "docs", "decision-records"],
+    review: ["repo-context", "docs", "decision-records", "issue-tracker", "external-docs"],
+    prepare: ["repo-context", "docs", "decision-records", "issue-tracker", "external-docs"],
+};
+export function selectPrepareEntries(entries, opts) {
+    if (opts.all || noSelector(opts))
+        return entries;
+    if (opts.source)
+        return selectBySource(entries, opts.source);
+    if (opts.lane) {
+        const selector = normalizeSelector(opts.lane);
+        return entries.filter((entry) => normalizeSelector(entry.rawLane ?? "") === selector);
+    }
+    if (opts.resource) {
+        const selector = normalizeSelector(opts.resource);
+        const category = resolveCategorySelector(selector);
+        if (!category) {
+            throw new Error(`resource selector "${opts.resource}" is not supported. Supported categories: ${PREPARE_RESOURCE_CATEGORIES.join(", ")}`);
+        }
+        return entries.filter((entry) => classifyPrepareEntry(entry) === category);
+    }
+    if (opts.consumer) {
+        const selector = normalizeSelector(opts.consumer);
+        const required = PREPARE_CONSUMER_REQUIREMENTS[selector];
+        if (!required) {
+            throw new Error(`consumer selector "${opts.consumer}" is not supported. Supported consumers: ${Object.keys(PREPARE_CONSUMER_REQUIREMENTS).join(", ")}`);
+        }
+        return entries.filter((entry) => required.includes(classifyPrepareEntry(entry)));
+    }
+    return entries;
+}
+export function buildPrepareReadinessMatrix(entries, results, opts, now = new Date()) {
+    const resultByPath = new Map(results.map((result) => [result.sourcePath, result]));
+    const selected = new Set(selectPrepareEntries(entries, opts).map((entry) => entry.path));
+    const rows = entries.map((entry) => {
+        const result = resultByPath.get(entry.path);
+        const category = classifyPrepareEntry(entry);
+        const consumers = consumersForCategory(category);
+        const status = readinessStatus(result, selected.has(entry.path));
+        return {
+            sourceKey: entry.id,
+            sourcePath: entry.path,
+            rawLane: entry.rawLane,
+            area: entry.area,
+            provider: entry.provider,
+            category,
+            consumers,
+            selected: selected.has(entry.path),
+            status,
+            syncStatus: result?.status,
+            snapshot: result?.snapshot,
+            changed: result?.changed,
+            reason: readinessReason(status, result),
+            retry: readinessRetry(status, result, entry, opts),
+            impact: readinessImpact(status, consumers),
+        };
+    });
+    return {
+        version: 1,
+        generatedAt: now.toISOString(),
+        selector: {
+            source: opts.source,
+            resource: opts.resource,
+            lane: opts.lane,
+            consumer: opts.consumer,
+            all: opts.all,
+        },
+        summary: summarizeRows(rows),
+        rows,
+    };
+}
+export function renderPrepareReadinessMatrix(matrix) {
+    const rows = matrix.rows
+        .map((row) => [
+        row.sourcePath,
+        row.category,
+        row.selected ? "yes" : "no",
+        row.status,
+        row.syncStatus ?? "-",
+        row.consumers.join(", ") || "-",
+        row.reason,
+        row.retry,
+        row.impact,
+    ].map((value) => escapeTable(value)).join(" | "));
+    return [
+        "# Prepare Readiness Matrix",
+        "",
+        `Generated: ${matrix.generatedAt}`,
+        "",
+        "## Summary",
+        "",
+        `- available: ${matrix.summary.available}`,
+        `- stale: ${matrix.summary.stale}`,
+        `- missing: ${matrix.summary.missing}`,
+        `- failed: ${matrix.summary.failed}`,
+        `- skipped: ${matrix.summary.skipped}`,
+        "",
+        "## Resources",
+        "",
+        "| Source | Category | Selected | Readiness | Sync | Consumers | Reason | Retry | Impact |",
+        "| --- | --- | --- | --- | --- | --- | --- | --- | --- |",
+        ...rows.map((row) => `| ${row} |`),
+        "",
+    ].join("\n");
+}
+export function classifyPrepareEntry(entry) {
+    const tokens = entryTokens(entry);
+    if (hasAny(tokens, ["issue", "issues", "bug", "bugs", "defect", "defects", "ticket", "tickets", "jira", "qa"])) {
+        return "issue-tracker";
+    }
+    if (hasAny(tokens, ["decision", "decisions", "adr", "adrs"]))
+        return "decision-records";
+    if (hasAny(tokens, ["repo", "repos", "repository", "repositories", "backend-repo", "backend_repo", "git", "code", "backend", "frontend", "openapi", "contract", "contracts"])) {
+        return "repo-context";
+    }
+    const origin = entry.source.origin;
+    if (origin?.url || hasAny(tokens, ["confluence", "figma", "external", "remote", "url", "http", "https"])) {
+        return "external-docs";
+    }
+    return "docs";
+}
+function noSelector(opts) {
+    return !opts.source && !opts.resource && !opts.lane && !opts.consumer;
+}
+function selectBySource(entries, selector) {
+    const exact = entries.filter((entry) => entry.id === selector || entry.path === selector || entry.segments.join(".") === selector);
+    if (exact.length > 0)
+        return exact;
+    const alias = entries.filter((entry) => entry.provider === selector);
+    if (alias.length > 1) {
+        const matches = alias.map((entry) => `${entry.path} (${entry.id})`).join(", ");
+        throw new Error(`source selector "${selector}" matched multiple configured sources: ${matches}. Use a source path or path-scoped id.`);
+    }
+    if (alias.length === 0) {
+        const available = entries.map((entry) => `${entry.path} (${entry.id})`).join(", ") || "none";
+        throw new Error(`source selector "${selector}" matched no configured sources. Available sources: ${available}.`);
+    }
+    return alias;
+}
+function resolveCategorySelector(selector) {
+    if (PREPARE_RESOURCE_CATEGORIES.includes(selector))
+        return selector;
+    const aliases = {
+        repo: "repo-context",
+        repository: "repo-context",
+        repositories: "repo-context",
+        code: "repo-context",
+        decisions: "decision-records",
+        decision: "decision-records",
+        adr: "decision-records",
+        issue: "issue-tracker",
+        issues: "issue-tracker",
+        defects: "issue-tracker",
+        bugs: "issue-tracker",
+        jira: "issue-tracker",
+        external: "external-docs",
+        remote: "external-docs",
+    };
+    return aliases[selector];
+}
+function readinessStatus(result, selected) {
+    if (!selected || !result)
+        return "skipped";
+    if (result.status === "materialized" || result.status === "materialized-partial" || result.status === "metadata-only") {
+        return "available";
+    }
+    if (result.previousSnapshotHash)
+        return "stale";
+    if (result.status === "source-gap" || result.status === "blocked-auth")
+        return "missing";
+    if (result.status === "failed")
+        return "failed";
+    return "skipped";
+}
+function readinessReason(status, result) {
+    if (!result)
+        return "Resource was not selected for this prepare run.";
+    if (status === "available")
+        return result.reason || "Source snapshot is available.";
+    if (status === "stale")
+        return `${result.reason || "Current sync did not refresh the source."} Previous snapshot is preserved.`;
+    return result.reason || "No readiness reason was provided by the adapter.";
+}
+function readinessRetry(status, result, entry, opts) {
+    if (status === "available")
+        return result?.changed ? "Review downstream consumers for freshness." : "No retry required.";
+    if (status === "skipped")
+        return `Run prepare sync with --source=${entry.path}, --resource=${classifyPrepareEntry(entry)}, --lane=${entry.rawLane ?? "lane"}, --consumer=<consumer>, or --all.`;
+    if (result?.status === "blocked-auth")
+        return "Fix credentials, provider readiness, --auth-state/--auth-profile, --browser, or --allow-network, then rerun prepare sync.";
+    if (result?.status === "source-gap")
+        return "Fix the configured origin path/URL/snapshot mapping, then rerun prepare sync.";
+    if (result?.status === "failed")
+        return "Inspect adapter-results for this source, repair the adapter/origin, then rerun prepare sync.";
+    const selector = opts.consumer ? `--consumer=${opts.consumer}` : opts.resource ? `--resource=${opts.resource}` : opts.lane ? `--lane=${opts.lane}` : "--all";
+    return `Rerun prepare sync ${selector} after fixing the resource.`;
+}
+function readinessImpact(status, consumers) {
+    if (status === "available")
+        return "No blocking impact.";
+    if (status === "skipped")
+        return consumers.length > 0 ? `Not refreshed for consumers: ${consumers.join(", ")}.` : "Not refreshed for any mapped consumer.";
+    return consumers.length > 0 ? `May block or degrade consumers: ${consumers.join(", ")}.` : "May block downstream consumers until accepted or repaired.";
+}
+function summarizeRows(rows) {
+    return rows.reduce((summary, row) => {
+        summary[row.status] += 1;
+        return summary;
+    }, { available: 0, stale: 0, missing: 0, failed: 0, skipped: 0 });
+}
+function consumersForCategory(category) {
+    return Object.entries(PREPARE_CONSUMER_REQUIREMENTS)
+        .filter(([, categories]) => categories.includes(category))
+        .map(([consumer]) => consumer)
+        .sort();
+}
+function entryTokens(entry) {
+    const values = [
+        entry.id,
+        entry.path,
+        entry.rawLane,
+        entry.area,
+        entry.provider,
+        entry.source.kind,
+        entry.source.type,
+        entry.source.adapter,
+        entry.source.provider,
+        entry.source.origin?.kind,
+        entry.source.origin?.provider,
+        entry.source.origin?.path,
+        entry.source.origin?.url,
+        entry.source.origin?.repository,
+        entry.resource?.type,
+        entry.resource?.area,
+    ];
+    const tokens = new Set();
+    for (const value of values) {
+        if (typeof value !== "string")
+            continue;
+        for (const token of value.split(/[^a-zA-Z0-9_/-]+|[/]+/)) {
+            const normalized = normalizeSelector(token);
+            if (normalized)
+                tokens.add(normalized);
+        }
+        tokens.add(normalizeSelector(value));
+    }
+    tokens.add(safeFileName(entry.id));
+    return tokens;
+}
+function hasAny(tokens, values) {
+    return values.some((value) => tokens.has(normalizeSelector(value)));
+}
+function normalizeSelector(value) {
+    return value.trim().toLowerCase().replace(/_/g, "-");
+}
+//# sourceMappingURL=prepare-readiness.js.map

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

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

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

@@ -1,6 +1,7 @@
 import { type ProjectConfig } from "./config.js";
 import { type ProviderReadinessEvidence } from "./provider-readiness.js";
 import { type PrepareSyncArtifacts } from "./prepare-artifacts.js";
+import { type PrepareReadinessMatrix } from "./prepare-readiness.js";
 import { type PrepareRouteResult } from "./prepare-routing.js";
 import { type PrepareSyncOptions, type PrepareSyncResult, type PrepareSyncStatus } from "./source-snapshot-adapters.js";
 export type { PrepareSyncOptions, PrepareSyncResult, PrepareSyncStatus };
@@ -16,6 +17,7 @@ export type PrepareSyncBundle = {
     providerReadiness: ProviderReadinessEvidence[];
     downstreamImpact: string;
     syncReport: string;
+    readinessMatrix: PrepareReadinessMatrix;
 };
 export type PrepareAuthCheckStatus = "ready" | "reachable" | "missing-auth" | "blocked-auth" | "source-gap" | "failed";
 export type PrepareAuthCheckResult = {

package/dist/core/prepare-sync.js

@@ -13,6 +13,7 @@ import { describeResource, updateRawIndexes, updateRawManifest } from "./raw-man
 import { createSyncRunId, resolvePrepareSyncArtifacts, } from "./prepare-artifacts.js";
 import { hashIfExists, sha256, writePreparedSnapshot } from "./prepare-materialization.js";
 import { renderDownstreamImpact, renderPreparationReport } from "./prepare-reporting.js";
+import { buildPrepareReadinessMatrix, renderPrepareReadinessMatrix, selectPrepareEntries, } from "./prepare-readiness.js";
 import { routePreparedResources } from "./prepare-routing.js";
 import { escapeTable, exists, isRecord, safeFileName } from "./prepare-utils.js";
 import { interpretSourceAdapter } from "./source-adapter-normalization.js";
@@ -29,7 +30,7 @@ export async function syncPrepareSources(target, config, opts = {}) {
     const runId = opts.runId ?? createSyncRunId();
     const artifacts = resolvePrepareSyncArtifacts(target, config, runId);
     const entries = flattenPrepareEntries(config);
-    const selected = new Set(selectSourceEntries(entries, opts));
+    const selected = new Set(selectPrepareEntries(entries, opts));
     const results = [];
     await mkdir(artifacts.adapterResultsDir, { recursive: true });
     await mkdir(artifacts.providerReadinessDir, { recursive: true });
@@ -56,6 +57,10 @@ export async function syncPrepareSources(target, config, opts = {}) {
     const syncReport = renderPreparationReport(entries, results, routes);
     await mkdir(dirname(artifacts.syncReportPath), { recursive: true });
     await writeFile(artifacts.syncReportPath, syncReport, "utf8");
+    const readinessMatrix = buildPrepareReadinessMatrix(entries, results, opts);
+    await mkdir(dirname(artifacts.readinessMatrixPath), { recursive: true });
+    await writeFile(artifacts.readinessMatrixPath, `${JSON.stringify(readinessMatrix, null, 2)}\n`, "utf8");
+    await writeFile(artifacts.readinessMatrixMarkdownPath, renderPrepareReadinessMatrix(readinessMatrix), "utf8");
     return {
         artifacts,
         results,
@@ -63,12 +68,13 @@ export async function syncPrepareSources(target, config, opts = {}) {
         providerReadiness: [...providerReadiness.byProvider.values()].map((item) => item.evidence),
         downstreamImpact,
         syncReport,
+        readinessMatrix,
     };
 }
 export async function checkPrepareAuth(target, config, opts = {}) {
     const runId = opts.runId ?? createSyncRunId();
     const artifacts = resolvePrepareSyncArtifacts(target, config, runId);
-    const entries = selectSourceEntries(flattenPrepareEntries(config), opts);
+    const entries = selectPrepareEntries(flattenPrepareEntries(config), opts);
     const authStatePath = resolveSelectedAuthStatePath(target, config, opts);
     const results = [];
     for (const entry of entries) {
@@ -78,20 +84,6 @@ export async function checkPrepareAuth(target, config, opts = {}) {
     await writeFile(artifacts.authCheckPath, `${JSON.stringify({ runId, results }, null, 2)}\n`, "utf8");
     return { artifacts, results };
 }
-function selectSourceEntries(entries, opts) {
-    if (opts.all || !opts.source)
-        return entries;
-    const selector = opts.source;
-    const exact = entries.filter((entry) => entry.id === selector || entry.path === selector || entry.segments.join(".") === selector);
-    if (exact.length > 0)
-        return exact;
-    const alias = entries.filter((entry) => entry.provider === selector);
-    if (alias.length > 1) {
-        const matches = alias.map((entry) => `${entry.path} (${entry.id})`).join(", ");
-        throw new Error(`source selector "${selector}" matched multiple configured sources: ${matches}. Use a source path or path-scoped id.`);
-    }
-    return alias;
-}
 async function resolveProviderReadiness(target, artifacts, entries) {
     const names = new Map();
     for (const entry of entries) {