mdkg 0.1.1 → 0.1.3

package/dist/commands/search.js

@@ -54,14 +54,14 @@ function runSearchCommand(options) {
     }
     const config = (0, config_1.loadConfig)(options.root);
     const ws = normalizeWorkspace(options.ws);
-    if (ws && !config.workspaces[ws]) {
+    if (ws && !config.workspaces[ws] && !config.bundle_imports[ws]) {
         throw new errors_1.NotFoundError(`workspace not found: ${ws}`);
     }
     const normalizedType = options.type?.toLowerCase();
     if (normalizedType === "skill") {
         throw new errors_1.UsageError("--type skill is no longer supported here; use `mdkg skill search`");
     }
-    const { index, rebuilt, stale } = (0, index_cache_1.loadIndex)({
+    const { index, rebuilt, stale, warnings } = (0, index_cache_1.loadIndex)({
         root: options.root,
         config,
         useCache: !options.noCache,
@@ -70,6 +70,9 @@ function runSearchCommand(options) {
     if (stale && !rebuilt && !options.noCache) {
         console.error("warning: index is stale; run mdkg index to refresh");
     }
+    for (const warning of warnings) {
+        console.error(`warning: ${warning}`);
+    }
     const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
     const nodeResults = (0, filter_1.filterNodes)(Object.values(index.nodes), {
         ws,

package/dist/commands/show.js

@@ -1,14 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runShowCommand = runShowCommand;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
 const config_1 = require("../core/config");
 const index_cache_1 = require("../graph/index_cache");
-const frontmatter_1 = require("../graph/frontmatter");
+const node_body_1 = require("../graph/node_body");
 const errors_1 = require("../util/errors");
 const qid_1 = require("../util/qid");
 const node_card_1 = require("./node_card");
@@ -34,14 +29,14 @@ function formatAttributeLine(key, value) {
 function runShowCommand(options) {
     const config = (0, config_1.loadConfig)(options.root);
     const ws = normalizeWorkspace(options.ws);
-    if (ws && !config.workspaces[ws]) {
+    if (ws && !config.workspaces[ws] && !config.bundle_imports[ws]) {
         throw new errors_1.NotFoundError(`workspace not found: ${ws}`);
     }
     const normalizedId = options.id.toLowerCase();
     if (normalizedId.startsWith("skill:") || normalizedId.startsWith("root:skill:")) {
         throw new errors_1.UsageError(`generic skill show is no longer supported; use \`mdkg skill show ${options.id.replace(/^root:skill:|^skill:/i, "")}\``);
     }
-    const { index, rebuilt, stale } = (0, index_cache_1.loadIndex)({
+    const { index, rebuilt, stale, warnings } = (0, index_cache_1.loadIndex)({
         root: options.root,
         config,
         useCache: !options.noCache,
@@ -50,19 +45,17 @@ function runShowCommand(options) {
     if (stale && !rebuilt && !options.noCache) {
         console.error("warning: index is stale; run mdkg index to refresh");
     }
+    for (const warning of warnings) {
+        console.error(`warning: ${warning}`);
+    }
     const resolved = (0, qid_1.resolveQid)(index, options.id, ws);
     if (resolved.status !== "ok") {
         throw new errors_1.NotFoundError((0, qid_1.formatResolveError)("id", options.id, resolved, ws));
     }
     const node = index.nodes[resolved.qid];
-    const filePath = path_1.default.resolve(options.root, node.path);
     let body = "";
     if (!options.metaOnly) {
-        if (!fs_1.default.existsSync(filePath)) {
-            throw new errors_1.NotFoundError(`file not found for ${node.qid}: ${node.path}`);
-        }
-        const content = fs_1.default.readFileSync(filePath, "utf8");
-        body = (0, frontmatter_1.parseFrontmatter)(content, filePath).body.trimEnd();
+        body = (0, node_body_1.readNodeBody)(options.root, node);
     }
     const format = options.format ?? (options.json ? "json" : undefined);
     if (format) {

package/dist/commands/skill_mirror.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.syncSkillMirrors = syncSkillMirrors;
+exports.preflightSkillMirrorTargets = preflightSkillMirrorTargets;
 exports.shouldMaintainSkillMirrors = shouldMaintainSkillMirrors;
 exports.auditSkillMirrors = auditSkillMirrors;
 exports.scaffoldMirrorRoots = scaffoldMirrorRoots;
@@ -271,6 +272,27 @@ function syncSkillMirrors(options) {
     }
     return { synced, pruned, targets: touchedTargets };
 }
+function preflightSkillMirrorTargets(options) {
+    if (options.force) {
+        return;
+    }
+    const slugs = Array.from(new Set(options.slugs.map((value) => value.trim().toLowerCase()).filter(Boolean)));
+    if (slugs.length === 0) {
+        return;
+    }
+    for (const target of resolveMirrorTargets(options.root)) {
+        if (!fs_1.default.existsSync(target.rootDir) && !fs_1.default.existsSync(target.skillsRoot)) {
+            continue;
+        }
+        const managed = readManifest(target);
+        for (const slug of slugs) {
+            const destDir = path_1.default.join(target.skillsRoot, slug);
+            if (fs_1.default.existsSync(destDir) && !managed.has(slug)) {
+                throw new errors_1.UsageError(`${path_1.default.relative(options.root, destDir)} already exists and is not mdkg-managed; rerun \`mdkg init --agent --force\` or \`mdkg skill sync --force\` to replace it`);
+            }
+        }
+    }
+}
 function shouldMaintainSkillMirrors(root) {
     return shouldCreateMirrorRoots(root);
 }

package/dist/commands/task.js

@@ -11,12 +11,15 @@ const path_1 = __importDefault(require("path"));
 const config_1 = require("../core/config");
 const indexer_1 = require("../graph/indexer");
 const index_cache_1 = require("../graph/index_cache");
+const reindex_1 = require("../graph/reindex");
 const frontmatter_1 = require("../graph/frontmatter");
 const skills_indexer_1 = require("../graph/skills_indexer");
 const date_1 = require("../util/date");
 const errors_1 = require("../util/errors");
 const qid_1 = require("../util/qid");
 const id_1 = require("../util/id");
+const atomic_1 = require("../util/atomic");
+const lock_1 = require("../util/lock");
 const event_support_1 = require("./event_support");
 const checkpoint_1 = require("./checkpoint");
 const MUTABLE_TASK_TYPES = new Set(["task", "bug", "test"]);
@@ -93,8 +96,7 @@ function maybeReindex(root, config) {
     if (!config.index.auto_reindex) {
         return;
     }
-    const outputPath = path_1.default.resolve(root, config.index.global_index_path);
-    (0, index_cache_1.writeIndex)(outputPath, (0, indexer_1.buildIndex)(root, config, { tolerant: config.index.tolerant }));
+    (0, reindex_1.writeDerivedIndexes)(root, config, (0, indexer_1.buildIndex)(root, config, { tolerant: config.index.tolerant }));
 }
 function loadMutableTaskNode(root, idOrQid, wsHint) {
     const config = (0, config_1.loadConfig)(root);
@@ -107,6 +109,9 @@ function loadMutableTaskNode(root, idOrQid, wsHint) {
     if (!node) {
         throw new errors_1.NotFoundError(`task not found: ${idOrQid}`);
     }
+    if (node.source?.imported) {
+        throw new errors_1.UsageError(`cannot mutate read-only imported node ${node.qid}; update the source workspace for bundle import ${node.source.import_alias}`);
+    }
     if (!MUTABLE_TASK_TYPES.has(node.type)) {
         throw new errors_1.UsageError(`mdkg task only supports task, bug, and test nodes; use markdown editing for ${node.type}:${node.id}`);
     }
@@ -129,7 +134,7 @@ function writeNodeFile(root, filePath, frontmatter, body) {
     const lines = (0, frontmatter_1.formatFrontmatter)(frontmatter, frontmatter_1.DEFAULT_FRONTMATTER_KEY_ORDER);
     const frontmatterBlock = ["---", ...lines, "---"].join("\n");
     const content = body.length > 0 ? `${frontmatterBlock}\n${body}` : frontmatterBlock;
-    fs_1.default.writeFileSync(filePath, content, "utf8");
+    (0, atomic_1.atomicWriteFile)(filePath, content);
 }
 function ensureStatusAllowed(config, statusRaw, flag = "--status") {
     const normalized = statusRaw.trim().toLowerCase();
@@ -199,7 +204,7 @@ function printTaskMutationReceipt(action, root, loaded, json, checkpoint) {
     }
     console.log(`task ${action}: ${loaded.qid}`);
 }
-function runTaskStartCommand(options) {
+function runTaskStartCommandLocked(options) {
     const loaded = loadMutableTaskNode(options.root, options.id, options.ws);
     const now = options.now ?? new Date();
     loaded.frontmatter.status = ensureStatusAllowed(loaded.config, "progress");
@@ -219,7 +224,7 @@ function runTaskStartCommand(options) {
     maybeWarnEventsDisabled(options.root, loaded.config, loaded.ws);
     printTaskMutationReceipt("started", options.root, loaded, options.json);
 }
-function runTaskUpdateCommand(options) {
+function runTaskUpdateCommandLocked(options) {
     const loaded = loadMutableTaskNode(options.root, options.id, options.ws);
     const now = options.now ?? new Date();
     if (options.status) {
@@ -261,7 +266,7 @@ function runTaskUpdateCommand(options) {
     });
     printTaskMutationReceipt("updated", options.root, loaded, options.json);
 }
-function runTaskDoneCommand(options) {
+function runTaskDoneCommandLocked(options) {
     const loaded = loadMutableTaskNode(options.root, options.id, options.ws);
     const now = options.now ?? new Date();
     const nextLinks = appendUnique(toStringList(loaded.frontmatter.links), parseCsvList(options.addLinks));
@@ -313,3 +318,15 @@ function runTaskDoneCommand(options) {
     maybeWarnEventsDisabled(options.root, loaded.config, loaded.ws);
     printTaskMutationReceipt("done", options.root, loaded, options.json, checkpoint);
 }
+function runTaskStartCommand(options) {
+    const config = (0, config_1.loadConfig)(options.root);
+    return (0, lock_1.withMutationLock)(options.root, config.index.lock_timeout_ms, () => runTaskStartCommandLocked(options));
+}
+function runTaskUpdateCommand(options) {
+    const config = (0, config_1.loadConfig)(options.root);
+    return (0, lock_1.withMutationLock)(options.root, config.index.lock_timeout_ms, () => runTaskUpdateCommandLocked(options));
+}
+function runTaskDoneCommand(options) {
+    const config = (0, config_1.loadConfig)(options.root);
+    return (0, lock_1.withMutationLock)(options.root, config.index.lock_timeout_ms, () => runTaskDoneCommandLocked(options));
+}

package/dist/commands/upgrade.js

@@ -18,6 +18,7 @@ const skill_mirror_1 = require("./skill_mirror");
 const DEFAULT_SEED_SUBDIR = path_1.default.resolve(__dirname, "..", "init");
 const PROTECTED_CORE_DOCS = new Set([".mdkg/core/SOUL.md", ".mdkg/core/HUMAN.md"]);
 const CREATE_ONLY_PRESERVED = new Set([".mdkg/core/core.md"]);
+const ARCHIVE_RAW_IGNORE_ENTRIES = [".mdkg/archive/**/source/"];
 function seededInitEvent(nowIso) {
     const event = {
         ts: nowIso,
@@ -107,7 +108,7 @@ function buildKnownHashes(manifests) {
     return hashes;
 }
 function shouldIncludeFile(file, agentWorkspace) {
-    if (file.category === "default_skill") {
+    if (file.category === "agent_doc" || file.category === "startup_doc" || file.category === "default_skill") {
         return agentWorkspace;
     }
     return file.category !== "config";
@@ -254,6 +255,27 @@ function ensureAgentRuntimeFiles(root, dryRun, summary, changes) {
         summary.unchanged += 1;
     }
 }
+function ensureArchiveIgnorePolicy(root, dryRun, summary, changes) {
+    const ignorePath = path_1.default.join(root, ".gitignore");
+    const raw = fs_1.default.existsSync(ignorePath) ? fs_1.default.readFileSync(ignorePath, "utf8") : "";
+    const lines = raw.split(/\r?\n/);
+    const existing = new Set(lines.map((line) => line.trim()).filter(Boolean));
+    const additions = ARCHIVE_RAW_IGNORE_ENTRIES.filter((entry) => !existing.has(entry));
+    if (additions.length === 0) {
+        summary.unchanged += 1;
+        return;
+    }
+    record(summary, changes, {
+        path: ".gitignore",
+        category: "ignore_policy",
+        action: fs_1.default.existsSync(ignorePath) ? "update" : "create",
+        reason: "ignore raw local archive source copies while keeping sidecars and zip caches commit-eligible",
+    });
+    if (!dryRun) {
+        const suffix = raw.length === 0 || raw.endsWith("\n") ? "" : "\n";
+        writeFile(ignorePath, `${raw}${suffix}${additions.join("\n")}\n`);
+    }
+}
 function isWritableChange(change) {
     return change.action === "create" || change.action === "update" || change.action === "migrate" || change.action === "sync";
 }
@@ -353,6 +375,7 @@ function runUpgradeCommand(options) {
     if (agentWorkspace) {
         ensureAgentRuntimeFiles(root, dryRun, summary, changes);
     }
+    ensureArchiveIgnorePolicy(root, dryRun, summary, changes);
     const applySideEffects = buildApplySideEffects({
         existingManifest,
         agentWorkspace,

package/dist/commands/validate.js

@@ -12,6 +12,9 @@ const node_1 = require("../graph/node");
 const skills_indexer_1 = require("../graph/skills_indexer");
 const workspace_files_1 = require("../graph/workspace_files");
 const validate_graph_1 = require("../graph/validate_graph");
+const bundle_imports_1 = require("../graph/bundle_imports");
+const visibility_1 = require("../graph/visibility");
+const sqlite_index_1 = require("../graph/sqlite_index");
 const errors_1 = require("../util/errors");
 const skill_mirror_1 = require("./skill_mirror");
 const RECOMMENDED_HEADINGS = {
@@ -205,6 +208,11 @@ function runValidateCommand(options) {
     const filesByAlias = (0, workspace_files_1.listWorkspaceDocFilesByAlias)(options.root, config);
     const errors = [];
     const warnings = [];
+    if ((0, sqlite_index_1.isSqliteBackend)(config)) {
+        const health = (0, sqlite_index_1.sqliteHealth)(options.root, config);
+        warnings.push(...health.warnings);
+        errors.push(...health.errors);
+    }
     if (templateSchemaInfo.fallbackTypes.length > 0) {
         warnings.push(`using bundled template schema fallback for missing local type(s): ${templateSchemaInfo.fallbackTypes.join(", ")}; run \`mdkg upgrade --apply\` to vendor built-in templates`);
     }
@@ -268,6 +276,16 @@ function runValidateCommand(options) {
         nodes,
         reverse_edges: {},
     };
+    const importProjection = (0, bundle_imports_1.buildBundleImportsIndex)(options.root, config);
+    for (const item of importProjection.index.imports) {
+        for (const warning of item.warnings) {
+            warnings.push(`bundle import ${item.alias}: ${warning}`);
+        }
+        for (const error of item.errors) {
+            errors.push(`bundle import ${item.alias}: ${error}`);
+        }
+    }
+    const validationIndex = (0, bundle_imports_1.mergeBundleImportsIntoIndex)(index, importProjection);
     let knownSkills = new Set();
     try {
         const skillsIndex = (0, skills_indexer_1.buildSkillsIndex)(options.root, config);
@@ -284,11 +302,12 @@ function runValidateCommand(options) {
         const message = err instanceof Error ? err.message : "unknown skill validation error";
         errors.push(message);
     }
-    const graphErrors = (0, validate_graph_1.collectGraphErrors)(index, {
+    const graphErrors = (0, validate_graph_1.collectGraphErrors)(validationIndex, {
         allowMissing: false,
         knownSkillSlugs: knownSkills,
     });
     errors.push(...graphErrors);
+    errors.push(...(0, visibility_1.visibilityViolationMessages)((0, visibility_1.collectVisibilityViolations)(validationIndex, config)).map((message) => `visibility: ${message}`));
     const skillsRoot = (0, skills_indexer_1.resolveSkillsRoot)(options.root, config);
     for (const dirPath of listDirectories(skillsRoot)) {
         const canonicalPath = path_1.default.join(dirPath, "SKILL.md");