mdkg 0.0.2 → 0.0.4

package/dist/commands/init.js

@@ -7,7 +7,17 @@ exports.runInitCommand = runInitCommand;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const errors_1 = require("../util/errors");
+const date_1 = require("../util/date");
+const skill_support_1 = require("./skill_support");
 const DEFAULT_SEED_SUBDIR = path_1.default.resolve(__dirname, "..", "init");
+const SOUL_PIN_ID = "rule-soul";
+const HUMAN_PIN_ID = "rule-human";
+const DEFAULT_CORE_LIST_HEADER = [
+    "# mdkg verbose core list",
+    "",
+    "# One node ID per line. Lines starting with # are comments.",
+    "# This list is included by `mdkg pack --verbose`.",
+];
 function listFiles(dir) {
     if (!fs_1.default.existsSync(dir)) {
         return [];
@@ -59,16 +69,166 @@ function appendIgnoreEntries(filePath, entries) {
     fs_1.default.writeFileSync(filePath, updated, "utf8");
     return true;
 }
+function writeFileIfMissing(filePath, content, force, stats) {
+    if (fs_1.default.existsSync(filePath) && !force) {
+        stats.skipped += 1;
+        return;
+    }
+    fs_1.default.mkdirSync(path_1.default.dirname(filePath), { recursive: true });
+    fs_1.default.writeFileSync(filePath, content, "utf8");
+    stats.created += 1;
+}
+function soulTemplate(created) {
+    return [
+        "---",
+        `id: ${SOUL_PIN_ID}`,
+        "type: rule",
+        "title: agent soul and execution contract",
+        "tags: [omni, agent, constraints]",
+        "owners: []",
+        "links: []",
+        "artifacts: []",
+        "relates: []",
+        "refs: []",
+        "aliases: [soul]",
+        `created: ${created}`,
+        `updated: ${created}`,
+        "---",
+        "",
+        "# Purpose",
+        "",
+        "Define the canonical agent execution boundaries and memory contract for this repository.",
+        "",
+        "# Scope",
+        "",
+        "Applies to all orchestrators and coding-agent executions using mdkg in this repo.",
+        "",
+        "# Requirements",
+        "",
+        "- Ask for approval before destructive operations or policy-sensitive actions.",
+        "- Prefer deterministic mdkg packs over ad-hoc context assembly.",
+        "- Follow single-writer commit discipline and event-driven batching.",
+        "- Never place secrets in mdkg docs or generated packs.",
+        "",
+        "# Notes",
+        "",
+        "Customize this file to encode repo-specific constraints, approval boundaries, and memory cadence.",
+        "",
+    ].join("\n");
+}
+function humanTemplate(created) {
+    return [
+        "---",
+        `id: ${HUMAN_PIN_ID}`,
+        "type: rule",
+        "title: human working profile and collaboration preferences",
+        "tags: [human, collaboration, preferences]",
+        "owners: []",
+        "links: []",
+        "artifacts: []",
+        "relates: []",
+        "refs: []",
+        "aliases: [human]",
+        `created: ${created}`,
+        `updated: ${created}`,
+        "---",
+        "",
+        "# Purpose",
+        "",
+        "Capture stable collaboration preferences and boundaries so agents can work with less ambiguity.",
+        "",
+        "# Scope",
+        "",
+        "Applies to planning, implementation, and review interactions in this repository.",
+        "",
+        "# Requirements",
+        "",
+        "- Keep top goals, boundaries, and style preferences current.",
+        "- Include ask-before-doing constraints for risky or high-impact actions.",
+        "- Record preferred environment assumptions and validation commands.",
+        "",
+        "# Notes",
+        "",
+        "Suggested prompts:",
+        "- What are your top 3 goals in this repo right now?",
+        "- What should never happen without confirmation?",
+        "- What coding/review style should the agent prefer?",
+        "- What OS/runtime/test commands should be assumed?",
+        "",
+    ].join("\n");
+}
+function seededInitEvent(nowIso) {
+    const event = {
+        ts: nowIso,
+        run_id: `init-${nowIso.replace(/[^0-9]/g, "").slice(0, 14)}`,
+        workspace: "root",
+        agent: "mdkg",
+        kind: "RUN_STARTED",
+        status: "ok",
+        refs: ["edd-4"],
+        artifacts: [],
+        notes: "init omni scaffold target initialized",
+        redacted: true,
+    };
+    return `${JSON.stringify(event)}\n`;
+}
+function parseCoreList(raw) {
+    const lines = raw.split(/\r?\n/);
+    const header = [];
+    const ids = [];
+    let seenFirstId = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const isComment = trimmed.startsWith("#");
+        if (!seenFirstId && (trimmed.length === 0 || isComment)) {
+            header.push(line);
+            continue;
+        }
+        if (trimmed.length === 0 || isComment) {
+            seenFirstId = true;
+            continue;
+        }
+        seenFirstId = true;
+        ids.push(trimmed.toLowerCase());
+    }
+    return { header, ids };
+}
+function ensureCorePins(coreListPath, requiredPins) {
+    const raw = fs_1.default.existsSync(coreListPath) ? fs_1.default.readFileSync(coreListPath, "utf8") : "";
+    const { header, ids } = parseCoreList(raw);
+    const seen = new Set();
+    const dedupedExisting = [];
+    for (const id of ids) {
+        if (seen.has(id)) {
+            continue;
+        }
+        seen.add(id);
+        dedupedExisting.push(id);
+    }
+    const required = requiredPins.map((value) => value.toLowerCase());
+    const filteredExisting = dedupedExisting.filter((value) => !required.includes(value));
+    const finalIds = [...required, ...filteredExisting];
+    const headerLines = header.length > 0 ? header : DEFAULT_CORE_LIST_HEADER;
+    const normalizedHeader = headerLines.slice();
+    while (normalizedHeader.length > 0 && normalizedHeader[normalizedHeader.length - 1].trim() === "") {
+        normalizedHeader.pop();
+    }
+    const output = [...normalizedHeader, "", ...finalIds, ""].join("\n");
+    fs_1.default.mkdirSync(path_1.default.dirname(coreListPath), { recursive: true });
+    fs_1.default.writeFileSync(coreListPath, output, "utf8");
+}
 function runInitCommand(options) {
     const root = path_1.default.resolve(options.root);
     const seedRoot = options.seedRoot ? path_1.default.resolve(options.seedRoot) : DEFAULT_SEED_SUBDIR;
     const createAgents = Boolean(options.createAgents || options.createLlm);
     const createClaude = Boolean(options.createClaude || options.createLlm);
+    const force = Boolean(options.force);
     const seedConfig = path_1.default.join(seedRoot, "config.json");
     const seedCore = path_1.default.join(seedRoot, "core");
     const seedTemplates = path_1.default.join(seedRoot, "templates");
     const seedAgents = path_1.default.join(seedRoot, "AGENTS.md");
     const seedClaude = path_1.default.join(seedRoot, "CLAUDE.md");
+    const seedReadme = path_1.default.join(seedRoot, "README.md");
     if (!fs_1.default.existsSync(seedConfig) || !fs_1.default.existsSync(seedCore) || !fs_1.default.existsSync(seedTemplates)) {
         throw new errors_1.NotFoundError(`init assets not found at ${seedRoot} (try reinstalling mdkg)`);
     }
@@ -78,24 +238,54 @@ function runInitCommand(options) {
     if (createClaude && !fs_1.default.existsSync(seedClaude)) {
         throw new errors_1.NotFoundError(`init assets missing CLAUDE.md at ${seedRoot}`);
     }
+    if (!fs_1.default.existsSync(seedReadme)) {
+        throw new errors_1.NotFoundError(`init assets missing README.md at ${seedRoot}`);
+    }
     const mdkgDir = path_1.default.join(root, ".mdkg");
     fs_1.default.mkdirSync(mdkgDir, { recursive: true });
     fs_1.default.mkdirSync(path_1.default.join(mdkgDir, "work"), { recursive: true });
     fs_1.default.mkdirSync(path_1.default.join(mdkgDir, "design"), { recursive: true });
     const stats = { created: 0, skipped: 0 };
-    copySeedFile(seedConfig, path_1.default.join(mdkgDir, "config.json"), Boolean(options.force), stats);
-    copySeedDir(seedCore, path_1.default.join(mdkgDir, "core"), Boolean(options.force), stats);
-    copySeedDir(seedTemplates, path_1.default.join(mdkgDir, "templates"), Boolean(options.force), stats);
+    copySeedFile(seedConfig, path_1.default.join(mdkgDir, "config.json"), force, stats);
+    copySeedFile(seedReadme, path_1.default.join(mdkgDir, "README.md"), force, stats);
+    copySeedDir(seedCore, path_1.default.join(mdkgDir, "core"), force, stats);
+    copySeedDir(seedTemplates, path_1.default.join(mdkgDir, "templates"), force, stats);
     if (createAgents) {
-        copySeedFile(seedAgents, path_1.default.join(root, "AGENTS.md"), Boolean(options.force), stats);
+        copySeedFile(seedAgents, path_1.default.join(root, "AGENTS.md"), force, stats);
     }
     if (createClaude) {
-        copySeedFile(seedClaude, path_1.default.join(root, "CLAUDE.md"), Boolean(options.force), stats);
+        copySeedFile(seedClaude, path_1.default.join(root, "CLAUDE.md"), force, stats);
+    }
+    if (options.omni) {
+        const today = (0, date_1.formatDate)(new Date());
+        const soulPath = path_1.default.join(mdkgDir, "core", "SOUL.md");
+        const humanPath = path_1.default.join(mdkgDir, "core", "HUMAN.md");
+        const skillsDir = path_1.default.join(mdkgDir, "skills");
+        const registryPath = path_1.default.join(skillsDir, "registry.md");
+        const eventsDir = path_1.default.join(mdkgDir, "work", "events");
+        const eventsPath = path_1.default.join(eventsDir, "events.jsonl");
+        fs_1.default.mkdirSync(skillsDir, { recursive: true });
+        fs_1.default.mkdirSync(eventsDir, { recursive: true });
+        writeFileIfMissing(soulPath, soulTemplate(today), force, stats);
+        writeFileIfMissing(humanPath, humanTemplate(today), force, stats);
+        writeFileIfMissing(registryPath, (0, skill_support_1.registryTemplate)(), force, stats);
+        if (!fs_1.default.existsSync(eventsPath) || force) {
+            writeFileIfMissing(eventsPath, seededInitEvent(new Date().toISOString()), force, stats);
+        }
+        const coreListPath = path_1.default.join(mdkgDir, "core", "core.md");
+        ensureCorePins(coreListPath, [SOUL_PIN_ID, HUMAN_PIN_ID]);
     }
-    if (options.updateGitignore) {
-        appendIgnoreEntries(path_1.default.join(root, ".gitignore"), [".mdkg/index/", ".mdkg/pack/"]);
+    const noUpdateIgnores = Boolean(options.noUpdateIgnores);
+    const shouldUpdateGitignore = Boolean(options.updateGitignore || !noUpdateIgnores);
+    const shouldUpdateNpmignore = Boolean(options.updateNpmignore || !noUpdateIgnores);
+    if (shouldUpdateGitignore) {
+        appendIgnoreEntries(path_1.default.join(root, ".gitignore"), [
+            ".mdkg/index/",
+            ".mdkg/pack/",
+            ".mdkg/work/events/*.jsonl",
+        ]);
     }
-    if (options.updateNpmignore) {
+    if (shouldUpdateNpmignore) {
         appendIgnoreEntries(path_1.default.join(root, ".npmignore"), [".mdkg/", ".mdkg/index/", ".mdkg/pack/"]);
     }
     if (options.updateDockerignore) {
@@ -103,9 +293,10 @@ function runInitCommand(options) {
     }
     console.log(`mdkg init complete: ${stats.created} file(s) created, ${stats.skipped} skipped`);
     console.log("next:");
-    console.log("  mdkg index");
     console.log('  mdkg new task "..." --status todo --priority 1');
-    console.log("  mdkg list --status todo");
-    console.log("  mdkg pack <id> --verbose");
+    console.log('  mdkg search "..."');
+    console.log("  mdkg show <id>");
+    console.log("  mdkg next");
+    console.log("  mdkg pack <id>");
     console.log("  mdkg validate");
 }

package/dist/commands/list.js

@@ -8,6 +8,7 @@ const errors_1 = require("../util/errors");
 const qid_1 = require("../util/qid");
 const sort_1 = require("../util/sort");
 const node_card_1 = require("./node_card");
+const query_output_1 = require("./query_output");
 function normalizeWorkspace(value) {
     if (!value || value === "all") {
         return undefined;
@@ -20,6 +21,10 @@ function runListCommand(options) {
     if (ws && !config.workspaces[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 list`");
+    }
     const { index, rebuilt, stale } = (0, index_cache_1.loadIndex)({
         root: options.root,
         config,
@@ -39,13 +44,25 @@ function runListCommand(options) {
     }
     const filtered = (0, filter_1.filterNodes)(Object.values(index.nodes), {
         ws,
-        type: options.type,
+        type: normalizedType,
         status: options.status,
         epic: epicQid,
         priority: options.priority,
         blocked: options.blocked,
+        tags: options.tags,
+        tagsMode: options.tagsMode,
     });
     const sorted = (0, sort_1.sortNodesByQid)(filtered);
+    if (options.json) {
+        (0, query_output_1.writeJson)({
+            command: "list",
+            kind: "node",
+            count: sorted.length,
+            items: sorted.map(query_output_1.toNodeSummaryJson),
+        });
+        return;
+    }
+    (0, query_output_1.writeCount)(sorted.length, sorted.length === 0 ? "no nodes matched current filters" : undefined);
     for (const node of sorted) {
         console.log((0, node_card_1.formatNodeCard)(node));
     }

package/dist/commands/new.js

@@ -14,10 +14,11 @@ const loader_1 = require("../templates/loader");
 const date_1 = require("../util/date");
 const errors_1 = require("../util/errors");
 const qid_1 = require("../util/qid");
-const ID_RE = /^[a-z]+-[0-9]+$/;
-const ID_REF_RE = /^([a-z][a-z0-9_]*:)?[a-z]+-[0-9]+$/;
+const id_1 = require("../util/id");
+const event_support_1 = require("./event_support");
 const DEC_ID_RE = /^dec-[0-9]+$/;
 const DEC_STATUS = new Set(["proposed", "accepted", "rejected", "superseded"]);
+const SKILL_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const CORE_TYPES = new Set(["rule"]);
 const DESIGN_TYPES = new Set(["prd", "edd", "dec", "prop"]);
 function parseCsvList(raw) {
@@ -31,14 +32,14 @@ function parseCsvList(raw) {
 }
 function normalizeId(value, key) {
     const normalized = value.toLowerCase();
-    if (!ID_RE.test(normalized) && normalized !== "rule-guide") {
-        throw new errors_1.UsageError(`${key} entries must match <prefix>-<number>: ${value}`);
+    if (!(0, id_1.isCanonicalId)(normalized)) {
+        throw new errors_1.UsageError(`${key} entries must match <prefix>-<number> or reserved id: ${value}`);
     }
     return normalized;
 }
 function normalizeIdRef(value, key) {
     const normalized = value.toLowerCase();
-    if (!ID_REF_RE.test(normalized)) {
+    if (!(0, id_1.isCanonicalIdRef)(normalized)) {
         throw new errors_1.UsageError(`${key} entries must match <id> or <ws>:<id>: ${value}`);
     }
     return normalized;
@@ -55,6 +56,15 @@ function normalizeIdList(raw, key) {
 function normalizeIdRefList(raw, key) {
     return parseCsvList(raw).map((value) => normalizeIdRef(value, key));
 }
+function normalizeSkillList(raw) {
+    return parseCsvList(raw).map((value) => {
+        const normalized = value.toLowerCase();
+        if (!SKILL_SLUG_RE.test(normalized)) {
+            throw new errors_1.UsageError(`--skills entries must be kebab-case: ${value}`);
+        }
+        return normalized;
+    });
+}
 function normalizeWorkspace(value) {
     if (!value) {
         return "root";
@@ -206,8 +216,12 @@ function runNewCommand(options) {
     const tags = normalizeLowercaseList(options.tags);
     const owners = normalizeLowercaseList(options.owners);
     const cases = normalizeLowercaseList(options.cases);
+    const skills = normalizeSkillList(options.skills);
     const links = normalizeList(options.links);
     const artifacts = normalizeList(options.artifacts);
+    if (skills.length > 0 && !node_1.WORK_TYPES.has(type)) {
+        throw new errors_1.UsageError("--skills is only valid for work items");
+    }
     if (type === "dec" && options.supersedes) {
         const supersedes = options.supersedes.toLowerCase();
         if (!DEC_ID_RE.test(supersedes)) {
@@ -263,6 +277,7 @@ function runNewCommand(options) {
         artifacts: artifacts.length > 0 ? artifacts : undefined,
         refs: refs.length > 0 ? refs : undefined,
         aliases: aliases.length > 0 ? aliases : undefined,
+        skills: skills.length > 0 ? skills : undefined,
         cases: cases.length > 0 ? cases : undefined,
         supersedes: options.supersedes ? options.supersedes.toLowerCase() : undefined,
         created: today,
@@ -275,5 +290,15 @@ function runNewCommand(options) {
         const outputPath = path_1.default.resolve(options.root, config.index.global_index_path);
         (0, index_cache_1.writeIndex)(outputPath, updatedIndex);
     }
+    (0, event_support_1.appendAutomaticEvent)({
+        root: options.root,
+        ws,
+        kind: "NODE_CREATED",
+        status: "ok",
+        refs: [id],
+        notes: `node created via mdkg new`,
+        runId: options.runId,
+        now: options.now,
+    });
     console.log(`node created: ${ws}:${id} (${path_1.default.relative(options.root, filePath)})`);
 }