dominds 0.1.0

package/dist/utils/id.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Module: id
+ *
+ * Utility functions for generating unique identifiers
+ * Used across the application without creating circular dependencies
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDialogID = generateDialogID;
+exports.generateContentHash = generateContentHash;
+const crypto = __importStar(require("crypto"));
+/**
+ * Generate a unique dialog ID
+ * Format: aa/bb/cccccccc where a,b are random bytes and c is time-based
+ */
+function generateDialogID() {
+    // a, b: 8-bit random values derived from a single Math.random() call
+    // c: lower 32 bits of system time
+    const r16 = Math.floor(Math.random() * 0x10000) & 0xffff; // two random bytes
+    const aByte = r16 & 0xff;
+    const bByte = (r16 >>> 8) & 0xff;
+    const time32 = (Date.now() & 0xffffffff) >>> 0;
+    const a = aByte.toString(16).padStart(2, '0');
+    const b = bByte.toString(16).padStart(2, '0');
+    const c = time32.toString(16).padStart(8, '0');
+    return `${a}/${b}/${c}`;
+}
+/**
+ * Generate deterministic hash ID for tool call content.
+ * Uses MD5 (faster, shorter output than SHA256) + local counter.
+ *
+ * @param content - The content to hash (e.g., "tool_name\nheadline\nbody")
+ * @param localCounter - Incremented per tool call in current parsing session
+ * @returns Short hash string (8 characters)
+ */
+function generateContentHash(content, localCounter) {
+    const payload = `${content}\n${localCounter}`;
+    return crypto.createHash('md5').update(payload).digest('hex').substring(0, 8);
+}

package/dist/utils/task-doc.js

@@ -0,0 +1,236 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTaskDocContent = formatTaskDocContent;
+/**
+ * Module: utils/task-doc
+ *
+ * Utilities for formatting task document content for display in LLM context.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const runtime_language_1 = require("../shared/runtime-language");
+const task_package_1 = require("./task-package");
+/**
+ * Format task document content for display in the LLM context.
+ * Task Docs are encapsulated `*.tsk/` directories.
+ */
+async function formatTaskDocContent(taskDocPath) {
+    const language = (0, runtime_language_1.getWorkLanguage)();
+    const workspaceRoot = path.resolve(process.cwd());
+    const fullPath = path.resolve(workspaceRoot, taskDocPath);
+    // Security check - ensure path is within workspace
+    if (!fullPath.startsWith(workspaceRoot)) {
+        const head = language === 'zh' ? `**差遣牒：** \`${taskDocPath}\`` : `**Task Doc:** \`${taskDocPath}\``;
+        const err = language === 'zh'
+            ? '❌ **错误：** 路径必须在 workspace 内'
+            : '❌ **Error:** Path must be within workspace';
+        return {
+            type: 'environment_msg',
+            role: 'user',
+            content: `${head}
+${err}`,
+        };
+    }
+    try {
+        if (!(0, task_package_1.isTaskPackagePath)(taskDocPath)) {
+            if (language === 'zh') {
+                return {
+                    type: 'environment_msg',
+                    role: 'user',
+                    content: `**差遣牒：** \`${taskDocPath}\`
+❌ **错误：** 无效的差遣牒路径：差遣牒必须是一个以 \`.tsk\` 结尾的目录（\`*.tsk/\`）。
+
+如果你提供的是一个普通文件路径（例如 \`.md\`），这是不符合预期的。请改为指向一个 \`.tsk/\` 目录。`,
+                };
+            }
+            return {
+                type: 'environment_msg',
+                role: 'user',
+                content: `**Task Doc:** \`${taskDocPath}\`
+❌ **Error:** Invalid Task Doc path: Task Doc must be a directory ending with \`.tsk\` (\`*.tsk/\`).
+
+If you provided a regular file path (e.g. a \`.md\`), that is unexpected. Please point to a \`.tsk/\` directory instead.`,
+            };
+        }
+        // Task Docs (`*.tsk/`) are directory-based, but the content is still injected deterministically.
+        // General file tools must NOT be used to access anything under `*.tsk/`.
+        const sections = await (async () => {
+            try {
+                const st = await fs.promises.stat(fullPath);
+                if (!st.isDirectory()) {
+                    throw new Error(`Task Doc path exists but is not a directory: '${taskDocPath}'`);
+                }
+                return await (0, task_package_1.readTaskPackageSections)(fullPath);
+            }
+            catch (err) {
+                if (typeof err === 'object' &&
+                    err !== null &&
+                    'code' in err &&
+                    err.code === 'ENOENT') {
+                    return {
+                        goals: { kind: 'missing' },
+                        constraints: { kind: 'missing' },
+                        progress: { kind: 'missing' },
+                    };
+                }
+                throw err;
+            }
+        })();
+        const goalsStatus = sections.goals.kind === 'present' ? 'present' : 'missing';
+        const constraintsStatus = sections.constraints.kind === 'present' ? 'present' : 'missing';
+        const progressStatus = sections.progress.kind === 'present' ? 'present' : 'missing';
+        const statusBlock = (() => {
+            if (language === 'zh') {
+                const goalsZh = goalsStatus === 'present' ? '存在' : '缺失';
+                const constraintsZh = constraintsStatus === 'present' ? '存在' : '缺失';
+                const progressZh = progressStatus === 'present' ? '存在' : '缺失';
+                return [
+                    `**差遣牒结构（封装差遣牒 \`*.tsk/\`）：**`,
+                    `- 我们的差遣牒是一个 \`*.tsk/\` 目录，分为 3 个分段：\`goals\` / \`constraints\` / \`progress\`。`,
+                    `- 维护方式：每次 \`!?@change_mind\` 必须指定一个分段（\`!goals\` / \`!constraints\` / \`!progress\`）；可在同一条消息中连续发出多个 \`!?@change_mind\` 来一次更新多个分段。`,
+                    ``,
+                    `**分段状态：**`,
+                    `- \`goals.md\`：${goalsZh}`,
+                    `- \`constraints.md\`：${constraintsZh}`,
+                    `- \`progress.md\`：${progressZh}`,
+                    ``,
+                    `若某个分段缺失，请用 \`!?@change_mind\` 创建（不要用通用文件工具）：`,
+                    `- \`!?@change_mind !goals\\n!?<content>\``,
+                    `- \`!?@change_mind !constraints\\n!?<content>\``,
+                    `- \`!?@change_mind !progress\\n!?<content>\``,
+                ].join('\n');
+            }
+            return [
+                `**Task Doc Constitution (Encapsulated \`*.tsk/\`):**`,
+                `- Our Task Doc is a \`*.tsk/\` directory with exactly 3 sections: \`goals\` / \`constraints\` / \`progress\`.`,
+                `- Maintenance: each \`!?@change_mind\` call must target one section (\`!goals\` / \`!constraints\` / \`!progress\`). You may include multiple \`!?@change_mind\` calls in a single message to update multiple sections.`,
+                ``,
+                `**Sections:**`,
+                `- \`goals.md\`: ${goalsStatus}`,
+                `- \`constraints.md\`: ${constraintsStatus}`,
+                `- \`progress.md\`: ${progressStatus}`,
+                ``,
+                `If any section is missing, create it with \`!?@change_mind\` (never via general file tools):`,
+                `- \`!?@change_mind !goals\\n!?<content>\``,
+                `- \`!?@change_mind !constraints\\n!?<content>\``,
+                `- \`!?@change_mind !progress\\n!?<content>\``,
+            ].join('\n');
+        })();
+        const effectiveDoc = (0, task_package_1.formatEffectiveTaskDocFromSections)(language, sections);
+        const bytes = Buffer.byteLength(effectiveDoc, 'utf8');
+        const maxSize = 100 * 1024; // 100KB
+        if (bytes > maxSize) {
+            if (language === 'zh') {
+                return {
+                    type: 'environment_msg',
+                    role: 'user',
+                    content: `**差遣牒：** \`${taskDocPath}\`
+📦 **类型：** 封装差遣牒（\`*.tsk/\`）
+📊 **大小：** ${(bytes / 1024).toFixed(1)} KB（过大，无法内联）
+
+${statusBlock}
+
+⚠️ **注意：** 差遣牒是封装的。不要用文件工具去读/写/列目录 \`*.tsk/\` 下的任何路径。
+请用 \`!?@change_mind !goals\` / \`!?@change_mind !constraints\` / \`!?@change_mind !progress\` 来更新（每次调用只更新一个分段；你可以在同一条消息里写多个 \`!?@change_mind\` 调用来批量更新）。`,
+                };
+            }
+            return {
+                type: 'environment_msg',
+                role: 'user',
+                content: `**Task Doc:** \`${taskDocPath}\`
+📦 **Type:** Encapsulated Task Doc (\`*.tsk/\`)
+📊 **Size:** ${(bytes / 1024).toFixed(1)} KB (too large to inline)
+
+${statusBlock}
+
+⚠️ **Note:** Task Docs are encapsulated. Do not use file tools to read/write/list anything under \`*.tsk/\`.
+Use \`!?@change_mind !goals\` / \`!?@change_mind !constraints\` / \`!?@change_mind !progress\` to update (each call updates one section; you may include multiple \`!?@change_mind\` calls in a single message to batch updates).`,
+            };
+        }
+        if (language === 'zh') {
+            return {
+                type: 'environment_msg',
+                role: 'user',
+                content: `**差遣牒：** \`${taskDocPath}\`
+📦 **类型：** 封装差遣牒（\`*.tsk/\`）
+📄 **大小：** ${bytes} bytes
+
+${statusBlock}
+
+---
+${effectiveDoc}
+---
+
+*用 \`!?@change_mind !goals\` / \`!?@change_mind !constraints\` / \`!?@change_mind !progress\` 来替换分段（每次调用只替换一个分段；你可以在同一条消息里写多个 \`!?@change_mind\` 调用来批量替换）。*
+
+指令：不要对 \`*.tsk/\` 下的任何路径调用通用文件工具（\`!?@read_file\`, \`!?@replace_file_contents\`, \`!?@plan_file_modification\`, \`!?@apply_file_modification\`, \`!?@list_dir\`, \`!?@rm_file\`, \`!?@rm_dir\`）。差遣牒状态只能通过显式的差遣牒操作进行管理。`,
+            };
+        }
+        return {
+            type: 'environment_msg',
+            role: 'user',
+            content: `**Task Doc:** \`${taskDocPath}\`
+📦 **Type:** Encapsulated Task Doc (\`*.tsk/\`)
+📄 **Size:** ${bytes} bytes
+
+${statusBlock}
+
+---
+${effectiveDoc}
+---
+
+*Use \`!?@change_mind !goals\` / \`!?@change_mind !constraints\` / \`!?@change_mind !progress\` to replace sections (each call replaces one section; you may include multiple \`!?@change_mind\` calls in a single message to batch replacements).*
+
+Directive: Do not invoke any general file tools (\`!?@read_file\`, \`!?@replace_file_contents\`, \`!?@plan_file_modification\`, \`!?@apply_file_modification\`, \`!?@list_dir\`, \`!?@rm_file\`, \`!?@rm_dir\`) on any path under \`*.tsk/\`. Task package state is managed only through explicit task-doc actions.`,
+        };
+    }
+    catch (error) {
+        if (language === 'zh') {
+            return {
+                type: 'environment_msg',
+                role: 'user',
+                content: `**差遣牒：** \`${taskDocPath}\`
+❌ **错误：** ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        return {
+            type: 'environment_msg',
+            role: 'user',
+            content: `**Task Doc:** \`${taskDocPath}\`
+❌ **Error:** ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}