@swarmvaultai/cli 0.7.1 → 0.7.21

package/README.md

@@ -70,7 +70,7 @@ Create a workspace with:
 
 The schema file is the vault-specific instruction layer. Edit it to define naming rules, categories, grounding expectations, and exclusions before a serious compile.
 
-`--profile` accepts `default`, `personal-research`, or a comma-separated preset list such as `reader,timeline`. For fully custom vault behavior, edit the `profile` block in `swarmvault.config.json`; that deterministic profile layer works alongside the human-written `swarmvault.schema.md`.
+`--profile` accepts `default`, `personal-research`, or a comma-separated preset list such as `reader,timeline`. For fully custom vault behavior, edit the `profile` block in `swarmvault.config.json`; that deterministic profile layer works alongside the human-written `swarmvault.schema.md`. The `personal-research` starter profile also sets `profile.guidedIngestDefault: true` and `profile.deepLintDefault: true`, so guided ingest/source and lint flows are on by default until you override them with `--no-guide` or `--no-deep`.
 
 ### `swarmvault source add|list|reload|review|guide|session|delete`
 
@@ -79,6 +79,7 @@ Manage recurring source roots through a registry-backed workflow.
 - `source add <input>` supports local files, local directories, public GitHub repo root URLs such as `https://github.com/karpathy/micrograd`, and docs/wiki/help/reference/tutorial hubs
 - by default `source add` registers the source, syncs it into the vault, runs one compile, and writes a source brief to `wiki/outputs/source-briefs/<source-id>.md`
 - add `--guide` when you want a resumable source session, source brief, source review, source guide, and approval-bundled canonical page edits when `profile.guidedSessionMode` is `canonical_review`, with `wiki/insights/` fallback for `insights_only`
+- set `profile.guidedIngestDefault: true` when guided mode should be the default for `source add` and `source reload`, and use `--no-guide` for individual light-path runs
 - `source list` shows every managed source with its kind, status, and current brief path
 - `source reload [id]` re-syncs one source, or use `--all` to refresh everything in the registry and compile once
 - `source review <id>` stages a lighter source-scoped review artifact
@@ -90,6 +91,7 @@ Useful flags:
 
 - `--all`
 - `--guide`
+- `--no-guide`
 - `--answers-file <path>`
 - `--no-compile`
 - `--no-brief`
@@ -107,14 +109,16 @@ Ingest a local file path, directory path, or URL into immutable source storage a
 - repo-aware directory ingest records `repoRelativePath` and later compile writes `state/code-index.json`
 - use `source add` instead when the same local directory, public GitHub repo root, or docs hub should stay registered and reloadable
 - URL ingest still localizes remote image references by default
-- local file ingest supports markdown, text, reStructuredText, HTML, PDF, DOCX, images, and code
+- local file and archive ingest supports markdown, text, reStructuredText, HTML, PDF, Word, RTF, OpenDocument, EPUB, CSV/TSV, Excel, PowerPoint, Jupyter notebooks, BibTeX, Org-mode, AsciiDoc, transcripts, Slack exports, email, calendar, structured config/data, developer manifests, images, and code
 - add `--guide` when you want a resumable source session, source brief, source review, source guide, and approval-bundled canonical page edits when `profile.guidedSessionMode` is `canonical_review`, with `wiki/insights/` fallback for `insights_only`
-- code-aware directory ingest currently covers JavaScript, JSX, TypeScript, TSX, Bash/shell scripts, Python, Go, Rust, Java, Kotlin, Scala, Dart, Lua, Zig, C#, C, C++, PHP, Ruby, and PowerShell
+- set `profile.guidedIngestDefault: true` when guided mode should be the default for `ingest`, and use `--no-guide` to force a plain ingest for one run
+- code-aware directory ingest currently covers JavaScript, JSX, TypeScript, TSX, Bash/shell scripts, Python, Go, Rust, Java, Kotlin, Scala, Dart, Lua, Zig, C#, C, C++, PHP, Ruby, PowerShell, Elixir, OCaml, Objective-C, ReScript, Solidity, HTML, CSS, and Vue single-file components
 
 Useful flags:
 
 - `--repo-root <path>`
 - `--answers-file <path>`
+- `--no-guide`
 - `--include <glob...>`
 - `--exclude <glob...>`
 - `--max-files <n>`
@@ -221,7 +225,7 @@ Each step:
 
 The command also writes a hub page linking the root question, saved step pages, and generated follow-up questions.
 
-### `swarmvault lint [--deep] [--web] [--conflicts]`
+### `swarmvault lint [--deep] [--no-deep] [--web] [--conflicts]`
 
 Run anti-drift and vault health checks such as stale pages, missing graph artifacts, contradiction findings, and other structural issues.
 
@@ -234,7 +238,9 @@ Run anti-drift and vault health checks such as stale pages, missing graph artifa
 - `candidate_page`
 - `follow_up_question`
 
-`--web` can only be used with `--deep`. It enriches deep-lint findings with external evidence snippets and URLs from a configured web-search provider.
+Set `profile.deepLintDefault: true` when deep lint should be the default for `swarmvault lint`, and use `--no-deep` when one run should stay structural only.
+
+`--web` can only be used when deep lint is enabled, either explicitly with `--deep` or through `profile.deepLintDefault`. It enriches deep-lint findings with external evidence snippets and URLs from a configured web-search provider.
 
 `--conflicts` filters the results down to contradiction-focused findings so you can audit conflicting claims without the rest of the lint output.
 

package/dist/index.js

@@ -268,9 +268,9 @@ program.name("swarmvault").description("SwarmVault is a local-first knowledge co
 function readCliVersion() {
   try {
     const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
-    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.1";
+    return typeof packageJson.version === "string" && packageJson.version.trim() ? packageJson.version : "0.7.21";
   } catch {
-    return "0.7.1";
+    return "0.7.21";
   }
 }
 function parsePositiveInt(value, fallback) {
@@ -427,9 +427,11 @@ program.command("init").description("Initialize a SwarmVault workspace in the cu
     log("Initialized SwarmVault workspace.");
   }
 });
-program.command("ingest").description("Ingest a local file path, directory path, or URL into the raw SwarmVault workspace.").argument("<input>", "Local file path, directory path, or URL").option("--review", "Stage a source review artifact after ingest and compile", false).option("--guide", "Stage a guided source integration bundle after ingest and compile", false).option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--include-assets", "Download remote image assets when ingesting URLs", true).option("--no-include-assets", "Skip downloading remote image assets when ingesting URLs").option("--max-asset-size <bytes>", "Maximum number of bytes to fetch for a single remote image asset").option("--repo-root <path>", "Override the detected repo root when ingesting a directory").option("--include <glob...>", "Only ingest files matching one or more glob patterns").option("--exclude <glob...>", "Skip files matching one or more glob patterns").option("--max-files <n>", "Maximum number of files to ingest from a directory").option("--include-third-party", "Also ingest repo files classified as third-party", false).option("--include-resources", "Also ingest repo files classified as resources", false).option("--include-generated", "Also ingest repo files classified as generated output", false).option("--no-gitignore", "Ignore .gitignore rules when ingesting a directory").action(
+program.command("ingest").description("Ingest a local file path, directory path, or URL into the raw SwarmVault workspace.").argument("<input>", "Local file path, directory path, or URL").option("--review", "Stage a source review artifact after ingest and compile", false).option("--guide", "Stage a guided source integration bundle after ingest and compile (default: from config)").option("--no-guide", "Skip guided mode even if enabled in config").option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--include-assets", "Download remote image assets when ingesting URLs", true).option("--no-include-assets", "Skip downloading remote image assets when ingesting URLs").option("--max-asset-size <bytes>", "Maximum number of bytes to fetch for a single remote image asset").option("--repo-root <path>", "Override the detected repo root when ingesting a directory").option("--include <glob...>", "Only ingest files matching one or more glob patterns").option("--exclude <glob...>", "Skip files matching one or more glob patterns").option("--max-files <n>", "Maximum number of files to ingest from a directory").option("--include-third-party", "Also ingest repo files classified as third-party", false).option("--include-resources", "Also ingest repo files classified as resources", false).option("--include-generated", "Also ingest repo files classified as generated output", false).option("--no-gitignore", "Ignore .gitignore rules when ingesting a directory").action(
   async (input, options) => {
     const guideAnswers = readGuideAnswersFile(options.answersFile);
+    const vaultConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
+    const guideEnabled = options.guide ?? vaultConfig?.config.profile.guidedIngestDefault ?? false;
     const maxAssetSize = typeof options.maxAssetSize === "string" && options.maxAssetSize.trim() ? parsePositiveInt(options.maxAssetSize, 0) || void 0 : void 0;
     const maxFiles = typeof options.maxFiles === "string" && options.maxFiles.trim() ? parsePositiveInt(options.maxFiles, 0) || void 0 : void 0;
     const extractClasses = [
@@ -452,7 +454,7 @@ program.command("ingest").description("Ingest a local file path, directory path,
       (fs) => fs.stat(input).then((stat) => stat.isDirectory() ? ingestDirectory(process2.cwd(), input, commonOptions) : null).catch(() => null)
     ) : null;
     if (directoryResult) {
-      const scope2 = options.review || options.guide ? await (async () => {
+      const scope2 = options.review || guideEnabled ? await (async () => {
         const pathModule = await import("path");
         const absoluteInput = pathModule.resolve(process2.cwd(), input);
         const sourceIds = (await listManifests(process2.cwd())).filter((manifest) => {
@@ -470,11 +472,11 @@ program.command("ingest").description("Ingest a local file path, directory path,
         } : void 0;
       })() : void 0;
       const shouldStage = Boolean(scope2 && (directoryResult.imported.length || directoryResult.updated.length));
-      const review3 = shouldStage && options.review && !options.guide ? await (async () => {
+      const review3 = shouldStage && options.review && !guideEnabled ? await (async () => {
         await compileVault(process2.cwd(), {});
         return await reviewSourceScope(process2.cwd(), scope2);
       })() : void 0;
-      const guide2 = shouldStage && options.guide ? await (async () => {
+      const guide2 = shouldStage && guideEnabled ? await (async () => {
         await compileVault(process2.cwd(), {});
         return await guideSourceScope(process2.cwd(), scope2, { answers: guideAnswers });
       })() : void 0;
@@ -502,11 +504,11 @@ program.command("ingest").description("Ingest a local file path, directory path,
     }
     const ingest = await ingestInputDetailed(process2.cwd(), input, commonOptions);
     const scope = sourceScopeFromManifests(input, [...ingest.created, ...ingest.updated, ...ingest.unchanged]);
-    const review2 = options.review && !options.guide && scope && (ingest.created.length || ingest.updated.length || ingest.unchanged.length) ? await (async () => {
+    const review2 = options.review && !guideEnabled && scope && (ingest.created.length || ingest.updated.length || ingest.unchanged.length) ? await (async () => {
       await compileVault(process2.cwd(), {});
       return await reviewSourceScope(process2.cwd(), scope);
     })() : void 0;
-    const guide = options.guide && scope && (ingest.created.length || ingest.updated.length || ingest.unchanged.length) ? await (async () => {
+    const guide = guideEnabled && scope && (ingest.created.length || ingest.updated.length || ingest.unchanged.length) ? await (async () => {
       await compileVault(process2.cwd(), {});
       return await guideSourceScope(process2.cwd(), scope, { answers: guideAnswers });
     })() : void 0;
@@ -547,14 +549,16 @@ program.command("add").description("Capture supported URLs into normalized markd
   }
 });
 var source = program.command("source").description("Manage recurring local files, directories, public repos, and docs sources.");
-source.command("add").description("Register and sync a managed source from a local file, directory, public GitHub repo root URL, or docs hub URL.").argument("<input>", "Local file path, directory path, public GitHub repo root URL, or docs hub URL").option("--no-compile", "Register and sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--review", "Stage a source review artifact after sync and compile", false).option("--guide", "Stage a guided source integration bundle after sync and compile", false).option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(
+source.command("add").description("Register and sync a managed source from a local file, directory, public GitHub repo root URL, or docs hub URL.").argument("<input>", "Local file path, directory path, public GitHub repo root URL, or docs hub URL").option("--no-compile", "Register and sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--review", "Stage a source review artifact after sync and compile", false).option("--guide", "Stage a guided source integration bundle after sync and compile (default: from config)").option("--no-guide", "Skip guided mode even if enabled in config").option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(
   async (input, options) => {
     const guideAnswers = readGuideAnswersFile(options.answersFile);
+    const addConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
+    const guideEnabled = options.guide ?? addConfig?.config.profile.guidedIngestDefault ?? false;
     const result = await addManagedSource(process2.cwd(), input, {
       compile: options.compile,
       brief: options.brief,
       review: options.review,
-      guide: options.guide,
+      guide: guideEnabled,
       guideAnswers,
       maxPages: options.maxPages ? parsePositiveInt(options.maxPages, 0) || void 0 : void 0,
       maxDepth: options.maxDepth ? parsePositiveInt(options.maxDepth, 0) || void 0 : void 0
@@ -583,16 +587,18 @@ source.command("list").description("List managed sources registered in this vaul
     }
   }
 });
-source.command("reload").description("Re-sync one managed source or all managed sources, then optionally compile and refresh briefs.").argument("[id]", "Managed source id").option("--all", "Reload all managed sources", false).option("--no-compile", "Re-sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--review", "Stage a source review artifact after sync and compile", false).option("--guide", "Stage a guided source integration bundle after sync and compile", false).option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(
+source.command("reload").description("Re-sync one managed source or all managed sources, then optionally compile and refresh briefs.").argument("[id]", "Managed source id").option("--all", "Reload all managed sources", false).option("--no-compile", "Re-sync without compiling the vault").option("--no-brief", "Skip source brief generation after sync").option("--review", "Stage a source review artifact after sync and compile", false).option("--guide", "Stage a guided source integration bundle after sync and compile (default: from config)").option("--no-guide", "Skip guided mode even if enabled in config").option("--answers-file <path>", "JSON file with guided-session answers keyed by question id or listed in prompt order").option("--max-pages <n>", "Maximum number of pages to crawl for docs sources").option("--max-depth <n>", "Maximum crawl depth for docs sources").action(
   async (id, options) => {
     const guideAnswers = readGuideAnswersFile(options.answersFile);
+    const reloadConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
+    const guideEnabled = options.guide ?? reloadConfig?.config.profile.guidedIngestDefault ?? false;
     const result = await reloadManagedSources(process2.cwd(), {
       id,
       all: options.all ?? false,
       compile: options.compile,
       brief: options.brief,
       review: options.review,
-      guide: options.guide,
+      guide: guideEnabled,
       guideAnswers,
       maxPages: options.maxPages ? parsePositiveInt(options.maxPages, 0) || void 0 : void 0,
       maxDepth: options.maxDepth ? parsePositiveInt(options.maxDepth, 0) || void 0 : void 0
@@ -732,9 +738,11 @@ program.command("benchmark").description("Measure graph-guided context reduction
     }
   }
 });
-program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint", false).option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
+program.command("lint").description("Run anti-drift and wiki-health checks.").option("--deep", "Run LLM-powered advisory lint (default: from config)").option("--no-deep", "Skip deep lint even if enabled in config").option("--web", "Augment deep lint with configured web search", false).option("--conflicts", "Filter to contradiction findings only", false).action(async (options) => {
+  const lintConfig = await loadVaultConfig(process2.cwd()).catch(() => null);
+  const deepEnabled = options.deep ?? lintConfig?.config.profile.deepLintDefault ?? false;
   const findings = await lintVault(process2.cwd(), {
-    deep: options.deep ?? false,
+    deep: deepEnabled,
     web: options.web ?? false,
     conflicts: options.conflicts ?? false
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/cli",
-  "version": "0.7.1",
+  "version": "0.7.21",
   "description": "Global CLI for SwarmVault.",
   "type": "module",
   "main": "dist/index.js",
@@ -38,7 +38,7 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@swarmvaultai/engine": "0.7.1",
+    "@swarmvaultai/engine": "0.7.21",
     "commander": "^14.0.1"
   },
   "devDependencies": {