@usecontextlayer/ctxe 0.5.10 → 0.5.12

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="72f8c26d-2a2d-55e1-9b82-bf3022922d48")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1fc8117f-7ec8-5237-b3fc-002c9d8e686e")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as Sentry from "@sentry/node";
 import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
@@ -61,7 +61,7 @@ var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version$2 = "0.5.10";
+var version$2 = "0.5.12";
 
 //#endregion
 //#region sentry.ts
@@ -30881,7 +30881,7 @@ function buildRootResetCommitMessage(input) {
 	return [
 		`ctxe: root reset @ ${input.resetId}`,
 		"",
-		"reset: wipe synthesized content + cursors",
+		"reset: wipe synthesized docs + cursors",
 		""
 	].join("\n");
 }
@@ -31414,7 +31414,7 @@ async function executeSynthesizerRun(input) {
 			sliceJson: input.sliceJson,
 			synthesizer: input.synthesizer,
 			synthesizerImage: input.synthesizerImage,
-			...input.outputHostDir !== void 0 && { outputHostDir: input.outputHostDir }
+			...input.docsHostDir !== void 0 && { docsHostDir: input.docsHostDir }
 		});
 		const result = await input.executor.run(executorInput, input.hooks);
 		const completedAtMs = now().getTime();
@@ -31468,7 +31468,7 @@ function buildExecutorInput(input) {
 		sliceJson: input.sliceJson,
 		synthesizerBody: input.synthesizer.body,
 		synthesizerName: input.synthesizer.name,
-		...input.outputHostDir !== void 0 && { outputHostDir: input.outputHostDir }
+		...input.docsHostDir !== void 0 && { docsHostDir: input.docsHostDir }
 	};
 }
 function buildContextEngineEnv(input) {
@@ -31761,10 +31761,10 @@ var Engine = class {
 		return (await executeSynthesizerRun({
 			baseDsn: this.baseDsn,
 			claudeOauthToken: config.claudeOauthToken,
+			docsHostDir: input.docsHostDir,
 			effortLevel: config.effortLevel,
 			executor: this.executor,
 			model: config.model,
-			outputHostDir: input.outputDir,
 			rootDir: this.repo.rootDir,
 			runId,
 			sliceJson,
@@ -32122,7 +32122,7 @@ engine has prepared three files in your working directory:
 
 - \`./synthesizer.md\` — your task definition. Read it first.
 - \`./slice.json\` — the source-time query windows for this run.
-- \`./output/\` — the only path that persists back to the host. Anything written
+- \`./docs/\` — the only path that persists back to the host. Anything written
   elsewhere is lost when the sandbox exits.
 
 A \`contextengine-synthesizer\` skill is installed. Read and follow it — it defines how to
@@ -32134,8 +32134,8 @@ not write a manifest or any end-of-run report.
 function workspaceGuestPath(rootDir) {
 	return path.resolve(rootDir);
 }
-function outputGuestPath(rootDir) {
-	return path.join(workspaceGuestPath(rootDir), "output");
+function docsGuestPath(rootDir) {
+	return path.join(workspaceGuestPath(rootDir), "docs");
 }
 function synthesizerGuestPath(rootDir) {
 	return path.join(workspaceGuestPath(rootDir), "synthesizer.md");
@@ -32150,8 +32150,8 @@ function buildSynthesizerSandboxLayout(input) {
 	const rootDir = path.resolve(input.rootDir);
 	return {
 		bindMounts: [{
-			guestPath: outputGuestPath(rootDir),
-			hostPath: input.outputHostDir ?? path.join(rootDir, "output"),
+			guestPath: docsGuestPath(rootDir),
+			hostPath: input.docsHostDir ?? path.join(rootDir, "docs"),
 			hostPathBehavior: "createDir",
 			mode: "rw"
 		}],
@@ -32259,7 +32259,7 @@ var MicrosandboxClaudeExecutor = class {
 				rootDir: input.rootDir,
 				sliceJson: input.sliceJson,
 				synthesizerBody: input.synthesizerBody,
-				...input.outputHostDir !== void 0 && { outputHostDir: input.outputHostDir }
+				...input.docsHostDir !== void 0 && { docsHostDir: input.docsHostDir }
 			});
 			const bootConfig = buildClaudeBootConfig({
 				bindMounts: layout.bindMounts,
@@ -32333,21 +32333,22 @@ function buildMicrosandboxClaudeRunPlan(input) {
 		sandboxName: input.sandboxName
 	};
 }
-const RESERVED_OUTPUT_SUBDIRS = new Set(["types", "views"]);
-const OUTPUT_DIR_RELATIVE = "output";
+const RESERVED_DOCS_SUBDIRS = new Set(["types", "views"]);
+const DOCS_SUBDIR = "docs";
 const CURSORS_DIR_RELATIVE = ".engine/cursors";
 async function planRootReset(rootDir) {
 	const cursorFiles = (await readDirNames(cursorsDirPath(rootDir))).filter((name) => name.endsWith(".json"));
+	const docsRemovalNames = (await readDirNames(path.join(rootDir, DOCS_SUBDIR))).filter((name) => !RESERVED_DOCS_SUBDIRS.has(name));
 	return {
-		contentPaths: (await readDirNames(path.join(rootDir, OUTPUT_DIR_RELATIVE))).filter((name) => !RESERVED_OUTPUT_SUBDIRS.has(name)).map((name) => path.join(OUTPUT_DIR_RELATIVE, name)).sort(),
-		cursorPaths: cursorFiles.map((name) => path.join(CURSORS_DIR_RELATIVE, name)).sort()
+		cursorPaths: cursorFiles.map((name) => path.join(CURSORS_DIR_RELATIVE, name)).sort(),
+		docsRemovalPaths: docsRemovalNames.map((name) => path.join(DOCS_SUBDIR, name)).sort()
 	};
 }
 async function runRootReset(repo, options = {}) {
 	const preflight = await runRootPreflight(repo);
 	if (!preflight.ready && !options.force) throw new Error(formatNotReadyError(repo, preflight.issues));
 	const plan = await planRootReset(repo.rootDir);
-	for (const relativePath of [...plan.cursorPaths, ...plan.contentPaths]) await rm(path.join(repo.rootDir, relativePath), {
+	for (const relativePath of [...plan.cursorPaths, ...plan.docsRemovalPaths]) await rm(path.join(repo.rootDir, relativePath), {
 		force: true,
 		recursive: true
 	});
@@ -32357,8 +32358,8 @@ async function runRootReset(repo, options = {}) {
 	return {
 		commit: { sha },
 		kind: "reset",
-		removedContent: plan.contentPaths,
-		removedCursors: plan.cursorPaths
+		removedCursors: plan.cursorPaths,
+		removedDocsPaths: plan.docsRemovalPaths
 	};
 }
 async function readDirNames(dir) {
@@ -38093,13 +38094,13 @@ async function runAdHocCommand(input) {
 		paths: input.paths,
 		workspaceId
 	});
-	const outputDir = resolve(input.out);
+	const docsHostDir = resolve(input.out);
 	const outcome = await engine.runAdHoc({
+		docsHostDir,
 		hooks: {
 			onStderr: (chunk) => process.stderr.write(chunk),
 			onStdout: (chunk) => process.stdout.write(chunk)
 		},
-		outputDir,
 		synthesizerName: input.synthesizerName,
 		...window.from !== void 0 && { fromMs: window.from },
 		...window.to !== void 0 && { toMs: window.to },
@@ -38108,7 +38109,7 @@ async function runAdHocCommand(input) {
 	process.stderr.write(`${formatJsonOutput({
 		durationMs: outcome.durationMs,
 		exitCode: outcome.exitCode,
-		out: outputDir,
+		out: docsHostDir,
 		status: outcome.status
 	})}\n`);
 	if (outcome.status !== "success") process.exitCode = 1;
@@ -38885,8 +38886,8 @@ async function runResetCommand(input) {
 			issues: preflight.issues,
 			ready: preflight.ready,
 			wouldRemove: {
-				content: plan.contentPaths,
-				cursors: plan.cursorPaths
+				cursors: plan.cursorPaths,
+				docs: plan.docsRemovalPaths
 			}
 		})}\n`);
 		return;
@@ -38966,7 +38967,7 @@ function createProgram() {
 	program.command("list").description("List synthesizers").action(async function() {
 		await runEngineListCommand(resolveRuntimePaths(this));
 	});
-	program.command("status").argument("[synthesizer]", "Only show this synthesizer").option("--workspace-id <id>", "Slate workspace id whose plan resolves the base to read sync state from. Falls back to CTXE_WORKSPACE_ID.").description("Print each synthesizer's freshness as JSON: its frontier (the source-time its cursor has reached), how far that lags behind now (output staleness), how much confirmed-synced ground is still pending below the sync horizon (whether the engine is keeping up — the planner's own measure), and its latest run.").action(async function(synthesizerName, options) {
+	program.command("status").argument("[synthesizer]", "Only show this synthesizer").option("--workspace-id <id>", "Slate workspace id whose plan resolves the base to read sync state from. Falls back to CTXE_WORKSPACE_ID.").description("Print each synthesizer's freshness as JSON: its frontier (the source-time its cursor has reached), how far that lags behind now (docs staleness), how much confirmed-synced ground is still pending below the sync horizon (whether the engine is keeping up — the planner's own measure), and its latest run.").action(async function(synthesizerName, options) {
 		const workspaceId = resolveWorkspaceId({ cliValue: options.workspaceId });
 		await runEngineStatusCommand(synthesizerName, resolveRuntimePaths(this), await resolveSyncHorizonCapture({ workspaceId }));
 	});
@@ -38979,14 +38980,14 @@ function createProgram() {
 	program.command("repair").description("Explicit out-of-band root repair: reconciles the root against origin (fast-forward when behind; publish own unpushed commits, or discard them to origin when the push is rejected) and rolls back a dirty tree preserving .engine/runs/**.").action(async function() {
 		await runRepairCommand(resolveRepoContext(this));
 	});
-	program.command("reset").option("--yes", "Execute the reset (delete cursors + wipe synthesized content, then commit). Without it, prints the plan and exits without mutating.").option("--force", "Reset even when the root is not preflight-ready (e.g. a dirty working tree). Use with care; normally you commit authored config or run 'ctxe repair' first.").description("Reset the whole workspace to a clean pre-synthesis state so it can be rebuilt from scratch: delete every synthesizer cursor (the next run bootstraps from the configured oldestConsideredPoint) and wipe all synthesized content under output/ except the authored types/ and views/, in one commit. Whole-workspace by design — output/ is not partitioned by synthesizer. Preserves .engine/runs/**. Default is a dry run; pass --yes to execute, then rebuild with 'ctxe backfill <synthesizer>' or 'ctxe daemon start'.").action(async function(options) {
+	program.command("reset").option("--yes", "Execute the reset (delete cursors + wipe synthesized docs, then commit). Without it, prints the plan and exits without mutating.").option("--force", "Reset even when the root is not preflight-ready (e.g. a dirty working tree). Use with care; normally you commit authored config or run 'ctxe repair' first.").description("Reset the whole workspace to a clean pre-synthesis state so it can be rebuilt from scratch: delete every synthesizer cursor (the next run bootstraps from the configured oldestConsideredPoint) and wipe all synthesized docs under docs/ except the authored types/ and views/, in one commit. Whole-workspace by design — docs/ is not partitioned by synthesizer. Preserves .engine/runs/**. Default is a dry run; pass --yes to execute, then rebuild with 'ctxe backfill <synthesizer>' or 'ctxe daemon start'.").action(async function(options) {
 		await runResetCommand({
 			force: options.force ?? false,
 			repo: resolveRepoContext(this),
 			yes: options.yes ?? false
 		});
 	});
-	program.command("adhoc").argument("<synthesizer>", "Synthesizer name").option("--from <iso>", "Window start (ISO-8601, exclusive). Defaults to the engine's oldestConsideredPoint when omitted.").option("--to <iso>", "Window end (ISO-8601, inclusive). Defaults to now when omitted.").option("--last <duration>", "Relative window ending now, e.g. \"7d\", \"12h\", \"30m\". Mutually exclusive with --from/--to.").requiredOption("--out <dir>", "Directory the synthesized output is written to. Used exactly as-is (created if missing); the synthesizer reads its current contents as prior output.").option("--workspace-id <id>", "Slate workspace id whose plan supplies the run config and the base to sync. Falls back to CTXE_WORKSPACE_ID.").option("--model <model>", "Override the plan's Claude model for this run only. Omitted → the workspace plan's model governs. Never persisted.").description("Ephemeral authoring run: run a synthesizer once over an explicit window into --out, reading your live (uncommitted) synthesizer.md and output/types. Touches nothing durable — no preflight, no sync horizon, no cursor, no commit, no push. Streams the run to stdout; saves no transcript. Exits non-zero on a non-success run.").action(async function(synthesizerName, options) {
+	program.command("adhoc").argument("<synthesizer>", "Synthesizer name").option("--from <iso>", "Window start (ISO-8601, exclusive). Defaults to the engine's oldestConsideredPoint when omitted.").option("--to <iso>", "Window end (ISO-8601, inclusive). Defaults to now when omitted.").option("--last <duration>", "Relative window ending now, e.g. \"7d\", \"12h\", \"30m\". Mutually exclusive with --from/--to.").requiredOption("--out <dir>", "Directory the synthesized docs are written to. Used exactly as-is (created if missing); the synthesizer reads its current contents as prior docs.").option("--workspace-id <id>", "Slate workspace id whose plan supplies the run config and the base to sync. Falls back to CTXE_WORKSPACE_ID.").option("--model <model>", "Override the plan's Claude model for this run only. Omitted → the workspace plan's model governs. Never persisted.").description("Ephemeral authoring run: run a synthesizer once over an explicit window into --out, reading your live (uncommitted) synthesizer.md. The guest's docs/ is exactly --out's contents — the checkout's docs/ (including docs/types) is NOT visible; copy docs/types into --out to give the run your live type-defs. Touches nothing durable — no preflight, no sync horizon, no cursor, no commit, no push. Streams the run to stdout; saves no transcript. Exits non-zero on a non-success run.").action(async function(synthesizerName, options) {
 		await runAdHocCommand({
 			from: options.from,
 			last: options.last,
@@ -39036,4 +39037,4 @@ runCli().catch((error) => {
 //#endregion
 export { createProgram, resolveRepoContext, resolveRuntimePaths, runCli };
 //# sourceMappingURL=cli.mjs.map
-//# debugId=72f8c26d-2a2d-55e1-9b82-bf3022922d48
+//# debugId=1fc8117f-7ec8-5237-b3fc-002c9d8e686e