@prover-coder-ai/context-doc 1.0.6 → 1.0.8

package/README.md

@@ -1,13 +1,21 @@
 # Knowledge Sync CLI
 
-Command: `npm run sync:knowledge` (or `knowledge-sync` when installed globally) — copies project dialogs into `.knowledge` for both Codex and Qwen.
+Command: `npx @prover-coder-ai/context-doc [flags]` (or `context-doc` when installed globally) — copies project dialogs into `.knowledge` for both Codex and Qwen.
 
 ## Installation (global CLI)
 - Install: `npm install -g @prover-coder-ai/context-doc`
 - Registry page: https://www.npmjs.com/package/@prover-coder-ai/context-doc
-- Run globally: `knowledge-sync [flags]`
+- Run globally: `context-doc [flags]`
+- Ad-hoc (no install): `npx @prover-coder-ai/context-doc [flags]`
 - Local (without global install): `npm run sync:knowledge` or `tsx src/shell/syncKnowledge.ts`
 
+## Usage examples
+- Default (auto-detect sources/destinations): `context-doc`
+- Custom Codex source/destination: `context-doc --source /tmp/project/.codex --dest /tmp/project/.knowledge/.codex`
+- Custom meta root (both Codex/Qwen resolution): `context-doc --meta-root /data/meta`
+- Override project URL: `context-doc --project-url https://github.com/your/repo`
+- Qwen source override: `context-doc --qwen-source /data/qwen/tmp/abcd1234`
+
 ## Flags
 - `--source, -s <path>` — explicit path to `.codex` (Codex source).
 - `--dest, -d <path>` — Codex destination root (defaults to `.knowledge/.codex`).

package/dist/shell/codexSync.js

@@ -28,31 +28,27 @@ const readRepositoryUrl = (cwd, repositoryUrlOverride) => Effect.try({
     },
     catch: () => syncError("package.json", "Cannot read repository url"),
 });
-const resolveSourceDir = (cwd, override, metaRoot) => Effect.try({
-    try: () => {
-        const envSource = process.env.CODEX_SOURCE_DIR;
-        const metaCandidate = metaRoot === undefined
-            ? undefined
-            : metaRoot.endsWith(".codex")
-                ? metaRoot
-                : path.join(metaRoot, ".codex");
-        const localSource = path.join(cwd, ".codex");
-        const homeSource = path.join(os.homedir(), ".codex");
-        const candidates = [
-            override,
-            envSource,
-            metaCandidate,
-            localSource,
-            homeSource,
-        ];
-        const existing = candidates.find((candidate) => candidate !== undefined && fs.existsSync(candidate));
-        if (existing === undefined) {
-            throw new Error("source .codex not found");
-        }
-        return existing;
-    },
-    catch: () => syncError(".codex", "Source .codex directory is missing"),
-});
+const resolveSourceDir = (cwd, override, metaRoot) => pipe(Effect.sync(() => {
+    const envSource = process.env.CODEX_SOURCE_DIR;
+    const metaCandidate = metaRoot === undefined
+        ? undefined
+        : metaRoot.endsWith(".codex")
+            ? metaRoot
+            : path.join(metaRoot, ".codex");
+    const localSource = path.join(cwd, ".codex");
+    const homeSource = path.join(os.homedir(), ".codex");
+    const candidates = [
+        override,
+        envSource,
+        metaCandidate,
+        localSource,
+        homeSource,
+    ].filter((candidate) => candidate !== undefined);
+    const existing = candidates.find((candidate) => fs.existsSync(candidate));
+    return { existing, candidates };
+}), Effect.flatMap(({ existing, candidates }) => existing === undefined
+    ? Effect.fail(syncError(".codex", `Source .codex directory is missing; checked: ${candidates.join(", ")}`))
+    : Effect.succeed(existing)));
 const collectJsonlFiles = (root) => Effect.try({
     try: () => {
         const collected = [];
@@ -115,5 +111,5 @@ export const syncCodex = (options) => Effect.gen(function* (_) {
     const allJsonlFiles = yield* _(collectJsonlFiles(sourceDir));
     const relevantFiles = yield* _(selectRelevantFiles(allJsonlFiles, locator));
     yield* _(Effect.forEach(relevantFiles, (filePath) => copyRelevantFile(sourceDir, destinationDir, filePath)));
-    yield* _(Console.log(`Synced ${relevantFiles.length} dialog files into .knowledge/.codex`));
-});
+    yield* _(Console.log(`Synced ${relevantFiles.length} dialog files into .knowledge/.codex from ${sourceDir}`));
+}).pipe(Effect.catchAll((error) => Console.log(`Codex source not found; skipped syncing Codex dialog files (${error.reason})`)));

package/dist/shell/qwenSync.js

@@ -26,7 +26,7 @@ const copyDirectoryJsonOnly = (sourceRoot, destinationRoot) => Effect.try({
     catch: () => syncError(sourceRoot, "Cannot traverse Qwen directory"),
 });
 const qwenHashFromPath = (projectPath) => createHash("sha256").update(projectPath).digest("hex");
-const resolveQwenSourceDir = (cwd, override, metaRoot) => pipe(Effect.sync(() => {
+const resolveQwenSourceDir = (cwd, override, metaRoot) => Effect.gen(function* (_) {
     const hash = qwenHashFromPath(cwd);
     const envSource = process.env.QWEN_SOURCE_DIR;
     const baseFromMeta = metaRoot === undefined
@@ -41,9 +41,11 @@ const resolveQwenSourceDir = (cwd, override, metaRoot) => pipe(Effect.sync(() =>
         baseFromMeta ? path.join(baseFromMeta, "tmp", hash) : undefined,
         path.join(cwd, ".qwen", "tmp", hash),
         path.join(homeBase, "tmp", hash),
-    ];
-    return candidates.find((candidate) => candidate !== undefined && fs.existsSync(candidate));
-}), Effect.flatMap((found) => found === undefined
-    ? Effect.fail(syncError(".qwen", "Qwen source directory is missing"))
-    : Effect.succeed(found)));
-export const syncQwen = (options) => pipe(resolveQwenSourceDir(options.cwd, options.qwenSourceDir, options.metaRoot), Effect.flatMap((qwenSource) => pipe(ensureDirectory(path.join(options.cwd, ".knowledge", ".qwen")), Effect.flatMap(() => copyDirectoryJsonOnly(qwenSource, path.join(options.cwd, ".knowledge", ".qwen"))), Effect.flatMap((copiedCount) => Console.log(`Synced ${copiedCount} Qwen dialog files into .knowledge/.qwen`)))), Effect.catchAll(() => Console.log("Qwen source not found; skipped syncing Qwen dialog files")));
+    ].filter((candidate) => candidate !== undefined);
+    const found = candidates.find((candidate) => fs.existsSync(candidate));
+    if (found === undefined) {
+        return yield* _(Effect.fail(syncError(".qwen", `Qwen source directory is missing; checked: ${candidates.join(", ")}`)));
+    }
+    return found;
+});
+export const syncQwen = (options) => pipe(resolveQwenSourceDir(options.cwd, options.qwenSourceDir, options.metaRoot), Effect.tap((qwenSource) => Console.log(`Qwen source resolved: ${qwenSource}`)), Effect.flatMap((qwenSource) => pipe(ensureDirectory(path.join(options.cwd, ".knowledge", ".qwen")), Effect.flatMap(() => copyDirectoryJsonOnly(qwenSource, path.join(options.cwd, ".knowledge", ".qwen"))), Effect.flatMap((copiedCount) => Console.log(`Synced ${copiedCount} Qwen dialog files into .knowledge/.qwen`)))), Effect.catchAll((error) => Console.log(`Qwen source not found; skipped syncing Qwen dialog files (${error.reason})`)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/context-doc",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "",
   "type": "module",
   "scripts": {
@@ -12,7 +12,7 @@
     "release": "npm run build && npm run lint && npm version patch && npm publish --access public"
   },
   "bin": {
-    "knowledge-sync": "dist/shell/syncKnowledge.js"
+    "context-doc": "dist/shell/syncKnowledge.js"
   },
   "repository": {
     "type": "git",

package/src/shell/codexSync.ts

@@ -46,8 +46,8 @@ const resolveSourceDir = (
 	override?: string,
 	metaRoot?: string,
 ): Effect.Effect<string, SyncError> =>
-	Effect.try({
-		try: () => {
+	pipe(
+		Effect.sync(() => {
 			const envSource = process.env.CODEX_SOURCE_DIR;
 			const metaCandidate =
 				metaRoot === undefined
@@ -63,19 +63,23 @@ const resolveSourceDir = (
 				metaCandidate,
 				localSource,
 				homeSource,
-			];
-			const existing = candidates.find(
-				(candidate) => candidate !== undefined && fs.existsSync(candidate),
-			);
-
-			if (existing === undefined) {
-				throw new Error("source .codex not found");
-			}
-
-			return existing;
-		},
-		catch: () => syncError(".codex", "Source .codex directory is missing"),
-	});
+			].filter((candidate): candidate is string => candidate !== undefined);
+
+			const existing = candidates.find((candidate) => fs.existsSync(candidate));
+
+			return { existing, candidates };
+		}),
+		Effect.flatMap(({ existing, candidates }) =>
+			existing === undefined
+				? Effect.fail(
+						syncError(
+							".codex",
+							`Source .codex directory is missing; checked: ${candidates.join(", ")}`,
+						),
+					)
+				: Effect.succeed(existing),
+		),
+	);
 
 const collectJsonlFiles = (
 	root: string,
@@ -183,7 +187,13 @@ export const syncCodex = (
 
 		yield* _(
 			Console.log(
-				`Synced ${relevantFiles.length} dialog files into .knowledge/.codex`,
+				`Synced ${relevantFiles.length} dialog files into .knowledge/.codex from ${sourceDir}`,
 			),
 		);
-	});
+	}).pipe(
+		Effect.catchAll((error) =>
+			Console.log(
+				`Codex source not found; skipped syncing Codex dialog files (${error.reason})`,
+			),
+		),
+	);

package/src/shell/qwenSync.ts

@@ -40,42 +40,49 @@ const resolveQwenSourceDir = (
 	override?: string,
 	metaRoot?: string,
 ): Effect.Effect<string, SyncError> =>
-	pipe(
-		Effect.sync(() => {
-			const hash = qwenHashFromPath(cwd);
-			const envSource = process.env.QWEN_SOURCE_DIR;
-			const baseFromMeta =
-				metaRoot === undefined
-					? undefined
-					: metaRoot.endsWith(".qwen")
-						? metaRoot
-						: path.join(metaRoot, ".qwen");
-			const homeBase = path.join(os.homedir(), ".qwen");
+	Effect.gen(function* (_) {
+		const hash = qwenHashFromPath(cwd);
+		const envSource = process.env.QWEN_SOURCE_DIR;
+		const baseFromMeta =
+			metaRoot === undefined
+				? undefined
+				: metaRoot.endsWith(".qwen")
+					? metaRoot
+					: path.join(metaRoot, ".qwen");
+		const homeBase = path.join(os.homedir(), ".qwen");
+
+		const candidates = [
+			override,
+			envSource,
+			baseFromMeta ? path.join(baseFromMeta, "tmp", hash) : undefined,
+			path.join(cwd, ".qwen", "tmp", hash),
+			path.join(homeBase, "tmp", hash),
+		].filter((candidate): candidate is string => candidate !== undefined);
 
-			const candidates = [
-				override,
-				envSource,
-				baseFromMeta ? path.join(baseFromMeta, "tmp", hash) : undefined,
-				path.join(cwd, ".qwen", "tmp", hash),
-				path.join(homeBase, "tmp", hash),
-			];
+		const found = candidates.find((candidate) => fs.existsSync(candidate));
 
-			return candidates.find(
-				(candidate) => candidate !== undefined && fs.existsSync(candidate),
+		if (found === undefined) {
+			return yield* _(
+				Effect.fail(
+					syncError(
+						".qwen",
+						`Qwen source directory is missing; checked: ${candidates.join(", ")}`,
+					),
+				),
 			);
-		}),
-		Effect.flatMap((found) =>
-			found === undefined
-				? Effect.fail(syncError(".qwen", "Qwen source directory is missing"))
-				: Effect.succeed(found),
-		),
-	);
+		}
+
+		return found;
+	});
 
 export const syncQwen = (
 	options: SyncOptions,
 ): Effect.Effect<void, SyncError> =>
 	pipe(
 		resolveQwenSourceDir(options.cwd, options.qwenSourceDir, options.metaRoot),
+		Effect.tap((qwenSource) =>
+			Console.log(`Qwen source resolved: ${qwenSource}`),
+		),
 		Effect.flatMap((qwenSource) =>
 			pipe(
 				ensureDirectory(path.join(options.cwd, ".knowledge", ".qwen")),
@@ -92,7 +99,9 @@ export const syncQwen = (
 				),
 			),
 		),
-		Effect.catchAll(() =>
-			Console.log("Qwen source not found; skipped syncing Qwen dialog files"),
+		Effect.catchAll((error) =>
+			Console.log(
+				`Qwen source not found; skipped syncing Qwen dialog files (${error.reason})`,
+			),
 		),
 	);