@okfit/cli 0.8.1 → 0.9.0

package/commands/sync.js

@@ -1,9 +1,9 @@
 import { CLI_VERSION } from "../version.js";
 import { displayRoot } from "../render/human.js";
-import { humanSync } from "../render/sync.js";
+import { humanPublication, humanSync } from "../render/sync.js";
 import { Argument, Command, Flag } from "effect/cli";
 import { CurrentDistribution } from "@effected/engine";
-import { Now, SyncEnvelope, jsonError, provideConfig, resolveProjectConfig, runSync, syncEnvelope } from "@okfit/engine";
+import { Now, SyncEnvelope, SyncPublicationConflictError, jsonError, provideConfig, resolveProjectConfig, runSync, stampPublication, syncEnvelope } from "@okfit/engine";
 import { Console, DateTime, Effect, Layer, Option, Path, Schema } from "effect";
 import { Git } from "@effected/git";
 import { GitHistory } from "@okfit/profiles";
@@ -42,9 +42,12 @@ const formatFlag = Flag.Literals("format", ["human", "json"]).pipe(Flag.withDefa
 const ISO_DATE = Schema.String.pipe(Schema.check(Schema.isPattern(/^\d{4}-\d{2}-\d{2}$/u, { message: "Expected a YYYY-MM-DD date" })));
 const sinceFlag = Flag.String("since").pipe(Flag.withSchema(ISO_DATE), Flag.optional, Flag.withDescription("log mode's inclusive floor (YYYY-MM-DD): consider every committed concept dated on or after it; default: the newest date already in log.md"));
 const stagedFlag = Flag.Boolean("staged").pipe(Flag.withDefault(false), Flag.withDescription("pre-commit mode: stamp only the concepts in the git index, with now as generated.at, and re-add what was written; log mode is excluded (default modes: generated, index)"));
+const publicationFlag = Flag.String("publication").pipe(Flag.optional, Flag.withDescription("restamp one Publication's renders digests after re-rendering its page; runs nothing else"));
 /**
 * `okfit sync [path] [--config <file>] [--only <mode>]... [--dry-run]
-* [--format human|json] [--since <YYYY-MM-DD>] [--staged]`.
+* [--format human|json] [--since <YYYY-MM-DD>] [--staged]
+* [--publication <id>]`. `--publication` runs only `stampPublication` and
+* rejects `--only`, `--staged` and `--since`.
 *
 * Handler order fixed by contract §4.3. Steps 1–3 are `context`'s/
 * `validate`'s handler in substance — stat `--config` (K-1) via
@@ -72,7 +75,8 @@ const syncCommand = Command.make("sync", {
 	dryRun: dryRunFlag,
 	format: formatFlag,
 	since: sinceFlag,
-	staged: stagedFlag
+	staged: stagedFlag,
+	publication: publicationFlag
 }, (input) => Effect.gen(function* () {
 	const cwd = process.cwd();
 	const discoveryCwd = Option.getOrElse(input.path, () => cwd);
@@ -84,6 +88,30 @@ const syncCommand = Command.make("sync", {
 			explicitConfigPath: input.config,
 			cwd
 		});
+		if (Option.isSome(input.publication)) {
+			const conflicts = [
+				...input.only.length > 0 ? ["--only"] : [],
+				...input.staged ? ["--staged"] : [],
+				...Option.isSome(input.since) ? ["--since"] : []
+			];
+			if (conflicts.length > 0) return yield* new SyncPublicationConflictError({ flags: conflicts });
+			const stamped = yield* stampPublication({
+				bundleRoot: resolved.bundleRoot,
+				id: input.publication.value,
+				dryRun: input.dryRun
+			});
+			if (input.format === "json") {
+				const envelope = syncEnvelope({
+					okfitVersion: CLI_VERSION,
+					root: displayRoot(cwd, resolved.bundleRoot, path),
+					dryRun: input.dryRun,
+					publication: stamped,
+					...Option.isSome(distribution) ? { distribution: distribution.value } : {}
+				});
+				yield* Console.log(JSON.stringify(Schema.encodeSync(SyncEnvelope)(envelope)));
+			} else for (const line of humanPublication(stamped, input.dryRun)) yield* Console.log(line);
+			return;
+		}
 		const modes = input.only.length > 0 ? new Set(input.only) : input.staged ? /* @__PURE__ */ new Set(["generated", "index"]) : /* @__PURE__ */ new Set([
 			"generated",
 			"index",

package/errors.js

@@ -1,7 +1,7 @@
 import { InitBundleDirError } from "./internal/initWizard.js";
 import { DocumentStdinIsTerminalError } from "./internal/stdin.js";
 import { Cancelled, ConfigIssueRenderer, NotInteractive } from "@effected/cli";
-import { ConfigMalformedError, ConfigPathNotFoundError, DocumentPathError, InitOverwriteError, QueryConceptNotFoundError, QuerySelectionError, QueryUnknownVocabularyError, SyncStagedLogError, VerifyConceptNotFoundError, VerifySelectionError, VerifyUnsupportedFrontmatterError } from "@okfit/engine";
+import { ConfigMalformedError, ConfigPathNotFoundError, DocumentPathError, InitOverwriteError, NotAPublicationError, PublicationNotFoundError, QueryConceptNotFoundError, QuerySelectionError, QueryUnknownVocabularyError, SyncPublicationConflictError, SyncStagedLogError, VerifyConceptNotFoundError, VerifySelectionError, VerifyUnsupportedFrontmatterError } from "@okfit/engine";
 
 //#region src/errors.ts
 const hasTag = (error, tag) => typeof error === "object" && error !== null && "_tag" in error && error._tag === tag;
@@ -79,6 +79,9 @@ const renderFailure = (error) => {
 	if (error instanceof VerifyConceptNotFoundError) return [`error: ${error.message}`];
 	if (error instanceof VerifyUnsupportedFrontmatterError) return [`error: ${error.message}`];
 	if (error instanceof SyncStagedLogError) return [`error: ${error.message}`];
+	if (error instanceof SyncPublicationConflictError) return [`error: ${error.message}`];
+	if (error instanceof PublicationNotFoundError) return error.publication === void 0 ? [`error: ${error.message}`, "hint: run okfit query --type Publication to list publication ids"] : [`error: ${error.message}`];
+	if (error instanceof NotAPublicationError) return [`error: ${error.message}`, "hint: run okfit query --type Publication to list publication ids"];
 	if (error instanceof VerifySelectionError) return [`error: ${error.message}`];
 	if (error instanceof QueryUnknownVocabularyError) return [`error: ${error.message}`];
 	if (error instanceof QueryConceptNotFoundError) return [`error: ${error.message}`];

package/index.d.ts

@@ -37,7 +37,7 @@ export declare const rootCommand: Command.Command<"okfit", {
   readonly human: readonly boolean[];
   readonly agent: readonly boolean[];
   readonly ci: readonly boolean[];
-}, import("@okfit/profiles").AgentActorUnconfiguredError | import("@okfit/core").BundleDepthExceededError | import("@okfit/core").BundleReadError | import("@okfit/core").BundleRootNotFoundError | import("@effected/cli").Cancelled | import("@effected/config-file").ConfigCodecError | import("@effected/config-file").ConfigFileReadError | import("@effected/config-file").ConfigFileWriteError | import("@okfit/engine").ConfigMalformedError | import("@okfit/engine").ConfigPathNotFoundError | import("@effected/config-file").ConfigValidationError | import("@okfit/engine").DocumentPathError | DocumentStdinIsTerminalError | import("@effected/markdown").FrontmatterEncodeError | import("@effected/markdown").FrontmatterFormatMismatchError | import("@effected/markdown").FrontmatterValidationError | import("@effected/git").GitCommandError | import("@okfit/profiles").GitHistoryError | import("@okfit/profiles").HumanActorUnresolvedError | InitBundleDirError | import("@okfit/engine").InitOverwriteError | import("@effected/markdown").MarkdownParseError | import("@effected/git").NotARepositoryError | import("@effected/cli").NotInteractive | import("effect/PlatformError").PlatformError | import("@okfit/engine").QueryConceptNotFoundError | import("@okfit/engine").QuerySelectionError | import("@okfit/engine").QueryUnknownVocabularyError | import("effect/Schema").SchemaError | import("@okfit/engine").SyncStagedLogError | import("@effected/git").UnknownRefError | import("@okfit/engine").VerifyConceptNotFoundError | import("@okfit/engine").VerifySelectionError | import("@okfit/engine").VerifyUnsupportedFrontmatterError | import("@effected/yaml").YamlParseError, import("@effected/xdg").AppDirs | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("@effected/cli").CliExit | import("@effected/cli").CliTheme | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("@okfit/engine").Now | import("effect/Path").Path | import("effect/Stdio").Stdio | import("@effected/xdg").Xdg>;
+}, import("@okfit/profiles").AgentActorUnconfiguredError | import("@okfit/core").BundleDepthExceededError | import("@okfit/core").BundleReadError | import("@okfit/core").BundleRootNotFoundError | import("@effected/cli").Cancelled | import("@effected/config-file").ConfigCodecError | import("@effected/config-file").ConfigFileReadError | import("@effected/config-file").ConfigFileWriteError | import("@okfit/engine").ConfigMalformedError | import("@okfit/engine").ConfigPathNotFoundError | import("@effected/config-file").ConfigValidationError | import("@okfit/engine").DocumentPathError | DocumentStdinIsTerminalError | import("@effected/markdown").FrontmatterEncodeError | import("@effected/markdown").FrontmatterFormatMismatchError | import("@effected/markdown").FrontmatterValidationError | import("@effected/git").GitCommandError | import("@okfit/profiles").GitHistoryError | import("@okfit/profiles").HumanActorUnresolvedError | InitBundleDirError | import("@okfit/engine").InitOverwriteError | import("@effected/markdown").MarkdownParseError | import("@okfit/engine").NotAPublicationError | import("@effected/git").NotARepositoryError | import("@effected/cli").NotInteractive | import("effect/PlatformError").PlatformError | import("@okfit/engine").PublicationNotFoundError | import("@okfit/engine").QueryConceptNotFoundError | import("@okfit/engine").QuerySelectionError | import("@okfit/engine").QueryUnknownVocabularyError | import("effect/Schema").SchemaError | import("@okfit/engine").SyncPublicationConflictError | import("@okfit/engine").SyncStagedLogError | import("@effected/git").UnknownRefError | import("@okfit/engine").UnsupportedFrontmatterError | import("@okfit/engine").VerifyConceptNotFoundError | import("@okfit/engine").VerifySelectionError | import("@okfit/engine").VerifyUnsupportedFrontmatterError | import("@effected/yaml").YamlParseError, import("@effected/xdg").AppDirs | import("effect/process/ChildProcessSpawner").ChildProcessSpawner | import("@effected/cli").CliExit | import("@effected/cli").CliTheme | import("effect/Crypto").Crypto | import("effect/FileSystem").FileSystem | import("@okfit/engine").Now | import("effect/Path").Path | import("effect/Stdio").Stdio | import("@effected/xdg").Xdg>;
 //#endregion
 //#region src/errors.d.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@okfit/cli",
-	"version": "0.8.1",
+	"version": "0.9.0",
 	"private": false,
 	"description": "The okfit command line: validate, lint, index, and inspect Open Knowledge Format (OKF) bundles.",
 	"keywords": [
@@ -55,9 +55,9 @@
 		"@effected/toml": "^0.11.0",
 		"@effected/walker": "^0.15.0",
 		"@effected/yaml": "^0.19.0",
-		"@okfit/core": "0.8.5",
-		"@okfit/engine": "0.11.1",
-		"@okfit/profiles": "0.8.3",
+		"@okfit/core": "0.9.0",
+		"@okfit/engine": "0.12.0",
+		"@okfit/profiles": "0.9.0",
 		"effect": "^4.0.0",
 		"ink": "^7.1.1",
 		"react": "^19.2.0"

package/render/sync.js

@@ -36,6 +36,17 @@ const humanSync = (result) => {
 	lines.push(result.dryRun ? `would write ${totalWritten}, unchanged ${totalUnchanged}, skipped ${totalSkipped} (dry run, nothing written)` : `wrote ${totalWritten}, unchanged ${totalUnchanged}, skipped ${totalSkipped}`);
 	return lines;
 };
+/**
+* Human output for `okfit sync --publication`: one line per rendered source's
+* digest, then whether the Publication file changed.
+*
+* @public
+*/
+const humanPublication = (result, dryRun) => [
+	`publication ${result.id}:`,
+	...result.digests.map((d) => `  ${d.path} ${d.body_sha256}`),
+	result.written ? dryRun ? `would restamp ${result.id} (dry run, nothing written)` : `restamped ${result.id}` : `unchanged ${result.id}`
+];
 
 //#endregion
-export { humanSync };
+export { humanPublication, humanSync };

package/version.js

@@ -11,7 +11,7 @@
 *
 * @public
 */
-const CLI_VERSION = "0.8.1";
+const CLI_VERSION = "0.9.0";
 
 //#endregion
 export { CLI_VERSION };