perttool 0.7.0 → 0.8.0

package/dist/cli.js

@@ -1,24 +1,10 @@
 #!/usr/bin/env node
-import { lstat, readFile } from "node:fs/promises";
+import { lstat } from "node:fs/promises";
 import process from "node:process";
 import { TextDecoder } from "node:util";
-import { analyzeDocument, checkDocument, selectNextTasks, } from "./application/contract7-assurance.js";
-import { planFormat, } from "./application/contract7-source.js";
-import { planProjectInit, projectInitResultToJson, renderProjectInitResult, withProjectInitOutput, } from "./application/init.js";
-import { planUnitMigration, withUnitMigrationWrite, } from "./application/contract7-unit-migration.js";
-import { getProjectMetadata, } from "./application/contract7-project.js";
-import { planAdvance, planBatchMutation, planFinishActuals, planLifecycle, planMutation, planAssuranceMutation, } from "./application/contract7-mutation.js";
-import { renderTargetGovernanceDecision, } from "./application/target-governance-projection.js";
-import { contract7InspectionResultToJson, contract7MutationResultToJson, contract7SnakeJson, } from "./application/contract7-projection.js";
-import { contract7ProjectResultToJson, renderContract7ProjectText, } from "./application/contract7-project.js";
-import { contract6WorkEventToJson, } from "./application/contract6-projection.js";
-import { renderAdvanceHistoryGuard, } from "./application/advance-history.js";
-import { prepareTargetPlanAssuranceAdvanceHistory, withTargetPlanAssuranceAdvanceHistoryRace, } from "./application/target-assurance-advance-history.js";
-import { persistTargetPlanAssuranceResult, } from "./application/target-assurance-write.js";
-import { inspectTargetPlanAssurance, } from "./application/target-assurance-inspection.js";
-import { inspectTargetProjectHistoryFile, renderTargetProjectHistoryText, targetProjectHistoryResultToJson, } from "./application/target-project-history.js";
-import { observeTargetProjectVelocity, renderTargetVelocityObservationText, targetVelocityObservationResultToJson, } from "./application/target-velocity-observation.js";
-import { getAgentHelp } from "./application/agent-help.js";
+import { createCliApplicationFacade, } from "./application/cli-facade.js";
+import { createNodeHost } from "./node/host.js";
+import { createHistoricalGraphGitEvidenceHost } from "./node/historical-host.js";
 import { exportMermaid, } from "./conversion/mermaid.js";
 import { importMermaid } from "./conversion/mermaid-import.js";
 import { getAssuranceGuide, renderAssuranceGuideResult, serializeAssuranceGuideResult, } from "./help/assurance-guide.js";
@@ -28,18 +14,16 @@ import { handlerCommandUsageError, } from "./command/usage.js";
 import { renderAssuranceCommandUsageError, serializeAssuranceCommandUsageError, validateAssuranceCommandInvocation, } from "./command/assurance-usage.js";
 import { agentGuidanceResultToJson } from "./guidance/projection.js";
 import { agentGuidanceExitCode, renderAgentGuidanceText, } from "./guidance/text.js";
-import { documentContentFromBytes, readDocumentFile, } from "./io/document-file.js";
-import { recheckAdvanceHistoryBaseline, } from "./history/git-probe.js";
-import { createArtifactFile, SafeWriteConflictError, SafeWriteVerificationError, } from "./io/safe-write.js";
+import { SafeWriteConflictError, SafeWriteVerificationError, } from "./io/safe-write.js";
 import { formatDecimal } from "./model/rational.js";
 import { convertWithVelocity, durationSuffix } from "./model/units.js";
 import { recommendationInvariantExitCode } from "./recommendation/failure.js";
 import { recommendationAnalysisToJson } from "./recommendation/json.js";
 import { TARGET_GRAMMAR_6_CAPABILITY, } from "./parser/document-parser.js";
-import { createTargetGrammar6DocumentFile, replaceTargetGrammar6DocumentFile, } from "./io/target-safe-write.js";
 import { exportPlanAssuranceMermaid, importPlanAssuranceMermaid, } from "./assurance/mermaid.js";
 import { getJsonSchemaResult, renderJsonSchemaResult, serializeJsonSchemaResult, } from "./schema/registry.js";
 import { TOOL_VERSION } from "./version.js";
+const { analyzeDocument, checkDocument, selectNextTasks, planFormat, planProjectInit, projectInitResultToJson, renderProjectInitResult, withProjectInitOutput, planUnitMigration, withUnitMigrationWrite, getProjectMetadata, contract7ProjectResultToJson, renderContract7ProjectText, planAdvance, planBatchMutation, planFinishActuals, planLifecycle, planMutation, planAssuranceMutation, renderTargetGovernanceDecision, contract7InspectionResultToJson, contract7MutationResultToJson, contract7SnakeJson, contract6WorkEventToJson, renderAdvanceHistoryGuard, prepareTargetPlanAssuranceAdvanceHistory, withTargetPlanAssuranceAdvanceHistoryRace, persistTargetPlanAssuranceResult, inspectTargetPlanAssurance, inspectTargetProjectHistoryFile, renderTargetProjectHistoryText, targetProjectHistoryResultToJson, observeTargetProjectVelocity, renderTargetVelocityObservationText, targetVelocityObservationResultToJson, getAgentHelp, documentContentFromBytes, readDocumentContent, readBytes, recheckAdvanceHistoryBaseline, createArtifactFile, createTargetGrammar6DocumentFile, replaceTargetGrammar6DocumentFile, inspectTargetHistoricalGraphFile, renderTargetHistoricalGraphText, targetHistoricalGraphResultToJson, } = createCliApplicationFacade(createNodeHost(), createHistoricalGraphGitEvidenceHost());
 class UsageError extends Error {
     code = "PTCLI-001";
 }
@@ -183,7 +167,7 @@ function renderDiagnostic(diagnostic, source, mode) {
 async function readDocument(source) {
     const content = source === "-"
         ? documentContentFromBytes(await readStdin())
-        : await readDocumentFile(source);
+        : await readDocumentContent(source);
     let modifiedAt = null;
     if (source !== "-") {
         try {
@@ -1097,7 +1081,7 @@ function previewResultJson(result, exposeCandidate, writeRequest = { mode: "prev
     };
 }
 async function readMutationRequest(source) {
-    const bytes = source === "-" ? await readStdin() : await readFile(source);
+    const bytes = source === "-" ? await readStdin() : await readBytes(source);
     const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
     try {
         return JSON.parse(text);
@@ -1517,6 +1501,60 @@ async function runProjectHistory(args) {
     }
     return ok ? 0 : 1;
 }
+async function runHistoricalGraph(args) {
+    const parsed = parseCommandOptions("dag.history", args);
+    if (parsed.positionals.length !== 1) {
+        throw new UsageError("dag history requires exactly one <file>");
+    }
+    const source = parsed.positionals[0];
+    if (source === "-") {
+        throw new UsageError("dag history requires an on-disk file");
+    }
+    const format = outputFormat(parsed.values.get("format"));
+    const color = colorMode(parsed.values.get("color"), format);
+    const maxDiagnostics = boundedInteger(parsed.values.get("max-diagnostics"), "max-diagnostics", 100, 1, 1000);
+    const ancestry = enumOption(parsed.values.get("history"), "history", new Set(["first-parent", "three-way"])) ?? "first-parent";
+    const view = enumOption(parsed.values.get("view"), "view", new Set(["snapshot", "lineage", "timeline"])) ?? "lineage";
+    const analysis = enumOption(parsed.values.get("analysis"), "analysis", new Set(["none", "precedence", "resource", "both"])) ?? "none";
+    const ancestryProfile = ancestry === "first-parent" ? "first_parent" : "three_way";
+    let result;
+    try {
+        result = await inspectTargetHistoricalGraphFile({
+            targetPath: source,
+            requestedEndpoint: parsed.values.get("rev") ?? "HEAD",
+            ...(parsed.values.get("base") === undefined
+                ? {}
+                : { lowerBoundary: parsed.values.get("base") }),
+            ancestryProfile,
+            view,
+            ...(parsed.values.get("snapshot") === undefined
+                ? {}
+                : { snapshotCommitId: parsed.values.get("snapshot") }),
+            analysisMode: analysis,
+            maxDiagnostics,
+        });
+    }
+    catch (error) {
+        return cliError(error instanceof Error ? error : new Error(String(error)), 3, "dag.history", format === "json");
+    }
+    const warningFailure = parsed.flags.has("warnings-as-errors") &&
+        (result.diagnosticsTruncated || result.diagnostics.some(({ severity }) => severity === "warning"));
+    const ok = result.ok && !warningFailure;
+    if (format === "json") {
+        writeJson(targetHistoricalGraphResultToJson(ok ? result : Object.freeze({ ...result, ok: false })));
+    }
+    else {
+        if (ok)
+            process.stdout.write(renderTargetHistoricalGraphText(result));
+        for (const diagnostic of result.diagnostics) {
+            process.stderr.write(`${renderDiagnostic(diagnostic, source, color)}\n`);
+        }
+        if (result.diagnosticsTruncated) {
+            process.stderr.write(`DIAGNOSTICS_TRUNCATED true limit=${maxDiagnostics}\n`);
+        }
+    }
+    return ok ? 0 : 1;
+}
 async function runProjectVelocityObservation(args) {
     const parsed = parseCommandOptions("project.observe-velocity", args);
     const format = outputFormat(parsed.values.get("format"));
@@ -2112,7 +2150,7 @@ async function runRender(args) {
             analysis,
             capacityOverrides: overrides,
             maxDiagnostics,
-        })
+        }, analyzeDocument)
         : null;
     const legacyExport = grammar6
         ? null
@@ -2229,7 +2267,7 @@ async function runImport(args) {
     }
     const profile2 = input.text.startsWith("flowchart LR\n  %% perttool:profile {\"schema_version\":\"Perttool.MermaidProfile.v2\"");
     const assuranceImport = profile2
-        ? importPlanAssuranceMermaid(input.text, TARGET_GRAMMAR_6_CAPABILITY)
+        ? importPlanAssuranceMermaid(input.text, TARGET_GRAMMAR_6_CAPABILITY, analyzeDocument)
         : null;
     const legacyImport = profile2
         ? null
@@ -3003,6 +3041,8 @@ async function dispatchCommand(descriptor, args) {
             return runAdvance(args);
         case "dag.render":
             return runRender(args);
+        case "dag.history":
+            return runHistoricalGraph(args);
         case "dag.import":
             return runImport(args);
         case "task.start":