@fenglimg/fabric-cli 2.0.0-rc.23 → 2.0.0-rc.25

package/dist/{doctor-R2E2XO6A.js → doctor-DXKPYPRC.js}

@@ -20,6 +20,7 @@ import {
   checkLockOrThrow,
   enrichDescriptions,
   runDoctorApplyLint as runDoctorFixKnowledge,
+  runDoctorArchiveHistory,
   runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorReport
@@ -89,6 +90,15 @@ var doctorCommand = defineCommand({
       default: "all",
       valueHint: "cc|codex|cursor|all"
     },
+    // v2.0.0-rc.24 TASK-10: --layer filter for the cite contract audit. Pairs
+    // with --cite-coverage. Validated against {'team','personal','all'} at
+    // command entry; rejects 'both' (rc.20 plan-context vocabulary) explicitly.
+    layer: {
+      type: "string",
+      description: t("cli.doctor.args.layer.description"),
+      default: "all",
+      valueHint: "team|personal|all"
+    },
     // rc.23 TASK-007 (a-C2): description-grade back-fill flag set. Read-side
     // by default; `--auto` flips the writer arm on. Mutually exclusive with
     // --fix / --fix-knowledge / --cite-coverage (different mutation surfaces).
@@ -106,6 +116,14 @@ var doctorCommand = defineCommand({
       type: "boolean",
       description: t("cli.doctor.args.dry-run.description"),
       default: false
+    },
+    // v2.0.0-rc.25 TASK-10: --archive-history flag (parallel to rc.20
+    // --cite-coverage). Read-only; reads session_archive_attempted events
+    // and renders a per-session table. Pairs with the shared `--since` flag.
+    "archive-history": {
+      type: "boolean",
+      description: t("cli.doctor.args.archive-history.description"),
+      default: false
     }
   },
   async run({ args }) {
@@ -124,6 +142,32 @@ var doctorCommand = defineCommand({
     const fix = args.fix === true;
     const citeCoverage = args["cite-coverage"] === true;
     const enrichDesc = args["enrich-descriptions"] === true;
+    const archiveHistory = args["archive-history"] === true;
+    if (archiveHistory) {
+      if (fix || fixKnowledge || citeCoverage || enrichDesc) {
+        writeStderr(t("cli.doctor.errors.archive-history-mutex"));
+        process.exitCode = 1;
+        return;
+      }
+      const sinceInput = args.since ?? "7d";
+      let sinceMs;
+      try {
+        sinceMs = parseSinceDuration(sinceInput);
+      } catch {
+        writeStderr(t("cli.doctor.errors.invalid-since", { input: sinceInput }));
+        process.exitCode = 1;
+        return;
+      }
+      const report2 = await runDoctorArchiveHistory(resolution.target, {
+        since: sinceMs
+      });
+      if (args.json === true) {
+        writeStdout(JSON.stringify(report2, null, 2));
+      } else {
+        renderArchiveHistoryReport(report2, sinceInput);
+      }
+      return;
+    }
     if (enrichDesc) {
       if (fix || fixKnowledge || citeCoverage) {
         writeStderr(t("cli.doctor.errors.enrich-descriptions-mutex"));
@@ -163,9 +207,16 @@ var doctorCommand = defineCommand({
         process.exitCode = 1;
         return;
       }
+      const layerFilter = args.layer ?? "all";
+      if (!isValidLayerFilter(layerFilter)) {
+        writeStderr(t("cli.doctor.errors.invalid-layer", { input: layerFilter }));
+        process.exitCode = 1;
+        return;
+      }
       const report2 = await runDoctorCiteCoverage(resolution.target, {
         since: sinceMs,
-        client: clientFilter
+        client: clientFilter,
+        layer: layerFilter
       });
       renderCiteCoverageReport(report2, args.json === true);
       return;
@@ -377,6 +428,14 @@ var CITE_COVERAGE_CLIENT_FILTERS = /* @__PURE__ */ new Set([
 function isValidClientFilter(input) {
   return CITE_COVERAGE_CLIENT_FILTERS.has(input);
 }
+var CITE_COVERAGE_LAYER_FILTERS = /* @__PURE__ */ new Set([
+  "team",
+  "personal",
+  "all"
+]);
+function isValidLayerFilter(input) {
+  return CITE_COVERAGE_LAYER_FILTERS.has(input);
+}
 function renderCiteCoverageReport(report, jsonMode) {
   if (jsonMode) {
     writeStdout(JSON.stringify(report, null, 2));
@@ -427,8 +486,83 @@ function renderCiteCoverageReport(report, jsonMode) {
       lines.push(`  ${label}: ${count}`);
     }
   }
+  appendContractSection(lines, report);
   writeStdout(lines.join("\n"));
 }
+function appendContractSection(lines, report) {
+  const status = report.contract_metrics_status;
+  if (status === void 0) {
+    return;
+  }
+  const metrics = report.contract_metrics;
+  const perLayerType = report.per_layer_type;
+  const allCountsZero = metrics === void 0 || metrics.decisions_cited === 0 && metrics.pitfalls_cited === 0 && metrics.contract_with === 0 && metrics.contract_missing === 0 && metrics.hard_violated === 0 && metrics.cite_id_unresolved === 0 && Object.keys(metrics.skip_count).length === 0;
+  if (status === "awaiting_marker" && allCountsZero) {
+    return;
+  }
+  lines.push("");
+  lines.push(`### ${t("cite-coverage.contract.header")}`);
+  if (status === "skipped:bootstrap_drift") {
+    lines.push(`  ${t("cite-coverage.contract.status.skipped_bootstrap_drift")}`);
+    return;
+  }
+  const statusKey = status === "ok" ? "cite-coverage.contract.status.ok" : "cite-coverage.contract.status.awaiting_marker";
+  lines.push(`  status: ${t(statusKey)}`);
+  if (typeof report.contract_marker_ts === "number" && report.contract_marker_ts > 0) {
+    lines.push(`  since: ${new Date(report.contract_marker_ts).toISOString()}`);
+  }
+  if (report.layer_filter !== void 0) {
+    lines.push(`  layer filter: ${report.layer_filter}`);
+  }
+  if (metrics !== void 0) {
+    lines.push(`  ${t("cite-coverage.contract.decisions_cited")}: ${metrics.decisions_cited}`);
+    lines.push(`  ${t("cite-coverage.contract.pitfalls_cited")}: ${metrics.pitfalls_cited}`);
+    lines.push(`  ${t("cite-coverage.contract.with")}: ${metrics.contract_with}`);
+    lines.push(`  ${t("cite-coverage.contract.missing")}: ${metrics.contract_missing}`);
+    if (metrics.hard_violated > 0) {
+      const layerSuffix = report.layer_filter === "personal" ? t("cite-coverage.layer.personal_fyi") : t("cite-coverage.layer.team_review");
+      lines.push(
+        `  ${t("cite-coverage.contract.hard_violated")} ${layerSuffix}: ${metrics.hard_violated}`
+      );
+    }
+  }
+  if (perLayerType !== void 0) {
+    const teamKeys = Object.keys(perLayerType.team).filter(
+      (k) => perLayerType.team[k] > 0
+    );
+    const personalKeys = Object.keys(perLayerType.personal).filter(
+      (k) => perLayerType.personal[k] > 0
+    );
+    if (teamKeys.length > 0 || personalKeys.length > 0) {
+      lines.push("");
+      lines.push(`#### ${t("cite-coverage.layer.team")} \xD7 ${t("cite-coverage.layer.personal")}`);
+      for (const key of teamKeys) {
+        const label = t(`cite-coverage.contract.type.${key}`);
+        lines.push(`  ${t("cite-coverage.layer.team")} \u2014 ${label}: ${perLayerType.team[key]}`);
+      }
+      for (const key of personalKeys) {
+        const label = t(`cite-coverage.contract.type.${key}`);
+        lines.push(
+          `  ${t("cite-coverage.layer.personal")} \u2014 ${label}: ${perLayerType.personal[key]}`
+        );
+      }
+    }
+  }
+  if (metrics !== void 0 && Object.keys(metrics.skip_count).length > 0) {
+    lines.push("");
+    lines.push(`#### ${t("cite-coverage.contract.skip_count")}`);
+    for (const [reason, count] of Object.entries(metrics.skip_count)) {
+      const label = t(`cite-coverage.skip.${reason}`);
+      lines.push(`  ${label}: ${count}`);
+    }
+  }
+  if (metrics !== void 0 && metrics.cite_id_unresolved > 0) {
+    lines.push("");
+    lines.push(
+      `${symbol.warn} ${t("cite-coverage.contract.cite_id_unresolved")}: ${metrics.cite_id_unresolved}`
+    );
+  }
+}
 function renderEnrichDescriptionsReport(report) {
   const header = `${symbol.ok} ${paint.ai("fab doctor --enrich-descriptions")} mode=${report.mode}${report.dryRun ? " (dry-run)" : ""} scanned=${report.scanned} modified=${report.modified} skipped=${report.skipped}`;
   writeStdout(header);
@@ -477,6 +611,44 @@ function parseSinceDuration(input) {
   }
   throw new Error(`invalid --since value: ${input}`);
 }
+function renderArchiveHistoryReport(report, sinceLabel) {
+  if (report.entries.length === 0) {
+    writeStdout(t("doctor.archive-history.empty", { sinceLabel }));
+    return;
+  }
+  const lines = [];
+  lines.push(
+    t("doctor.archive-history.header", {
+      sinceLabel,
+      count: String(report.total),
+      plural: report.total === 1 ? "" : "s"
+    })
+  );
+  lines.push("");
+  lines.push(
+    `| ${t("doctor.archive-history.table.session")} | ${t(
+      "doctor.archive-history.table.lastAttempt"
+    )} | ${t("doctor.archive-history.table.outcome")} | ${t(
+      "doctor.archive-history.table.candidates"
+    )} | ${t("doctor.archive-history.table.coveredGap")} |`
+  );
+  lines.push("| ------- | ---------------- | -------- | ---------- | ----------- |");
+  for (const entry of report.entries) {
+    const lastAttempt = formatTimestampForTable(entry.last_attempted_at);
+    lines.push(
+      `| ${entry.session_id_short} | ${lastAttempt} | ${entry.outcome} | ${entry.candidates_proposed} | ${entry.age_since_covered_hours}h |`
+    );
+  }
+  writeStdout(lines.join("\n"));
+}
+function formatTimestampForTable(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return iso;
+  const pad = (n) => n < 10 ? `0${n}` : `${n}`;
+  return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())} ${pad(
+    d.getUTCHours()
+  )}:${pad(d.getUTCMinutes())}`;
+}
 export {
   doctor_default as default,
   doctorCommand,

package/dist/index.js

@@ -11,8 +11,8 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-TDZYZV54.js").then((module) => module.default),
-  doctor: () => import("./doctor-R2E2XO6A.js").then((module) => module.default),
+  install: () => import("./install-S2J76N2B.js").then((module) => module.default),
+  doctor: () => import("./doctor-DXKPYPRC.js").then((module) => module.default),
   serve: () => import("./serve-NPCI342P.js").then((module) => module.default),
   uninstall: () => import("./uninstall-MQM6NUFM.js").then((module) => module.default),
   config: () => import("./config-XGUUAYX6.js").then((module) => module.default),
@@ -26,7 +26,7 @@ var allCommands = {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.0-rc.23",
+    version: "2.0.0-rc.25",
     description: t("cli.main.description")
   },
   subCommands: allCommands

package/dist/{install-TDZYZV54.js → install-S2J76N2B.js}

@@ -1348,7 +1348,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.0.0-rc.23" : "unknown";
+  return true ? "2.0.0-rc.25" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.0.0-rc.23",
+  "version": "2.0.0-rc.25",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -20,8 +20,8 @@
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "2.0.0-rc.23",
-    "@fenglimg/fabric-shared": "2.0.0-rc.23"
+    "@fenglimg/fabric-server": "2.0.0-rc.25",
+    "@fenglimg/fabric-shared": "2.0.0-rc.25"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",