@oyasmi/pipiclaw 0.5.4 → 0.5.5

package/README.md

@@ -140,6 +140,7 @@ pipiclaw
     ├── SOUL.md
     ├── AGENTS.md
     ├── MEMORY.md
+    ├── ENVIRONMENT.md
     ├── events/
     ├── skills/
     └── sub-agents/
@@ -385,6 +386,7 @@ Pipiclaw 的核心不是一个临时机器人实例，而是一组长期存在
     ├── SOUL.md
     ├── AGENTS.md
     ├── MEMORY.md
+    ├── ENVIRONMENT.md
     ├── events/
     ├── skills/
     ├── sub-agents/
@@ -395,8 +397,7 @@ Pipiclaw 的核心不是一个临时机器人实例，而是一组长期存在
     │   ├── .channel-meta.json
     │   ├── context.jsonl
     │   ├── log.jsonl
-    │   ├── subagent-runs.jsonl
-    │   └── skills/
+    │   └── subagent-runs.jsonl
     └── group_{conversationId}/
         └── ...
 ```

package/dist/agent/prompt-builder.js

@@ -31,6 +31,7 @@ ${workspacePath}/
 ├── SOUL.md                      # Your identity/personality (read-only)
 ├── AGENTS.md                    # Custom behavior instructions (read-only)
 ├── MEMORY.md                    # Stable workspace memory (admin-managed, read on demand)
+├── ENVIRONMENT.md               # Environment facts and notable machine-level changes (read on demand)
 ├── sub-agents/                  # Predefined sub-agent definitions
 ├── skills/                      # Global CLI tools you create
 ├── events/                      # Scheduled events
@@ -39,9 +40,7 @@ ${workspacePath}/
     ├── MEMORY.md                # Channel durable memory (read on demand, runtime-managed)
     ├── HISTORY.md               # Channel summarized history (read on demand, runtime-managed)
     ├── log.jsonl                # Raw message archive (cold storage)
-    ├── context.jsonl            # Raw session archive (cold storage)
-    ├── scratch/                 # Your working directory
-    └── skills/                  # Channel-specific tools`);
+    └── context.jsonl            # Raw session archive (cold storage)`);
     sections.push(`## Events
 You can schedule events that wake you up at specific times or when external things happen. Events are JSON files in \`${workspacePath}/events/\`.
 
@@ -80,6 +79,8 @@ Memory files are not preloaded into session context. Read them explicitly when m
 ### Files
 - Workspace memory: ${workspacePath}/MEMORY.md
   Stable shared background memory. Admin-managed. Read on demand.
+- Workspace environment: ${workspacePath}/ENVIRONMENT.md
+  Durable environment facts and notable machine-level changes. Read on demand when environment state or prior machine changes matter.
 - Channel session memory: ${channelPath}/SESSION.md
   Current working state for this channel. Runtime-managed. Read on demand. Prefer this when current task state matters.
 - Channel memory: ${channelPath}/MEMORY.md
@@ -92,20 +93,21 @@ Memory files are not preloaded into session context. Read them explicitly when m
 - SESSION.md is the primary runtime-managed working-state artifact for current active work.
 - The runtime automatically consolidates channel MEMORY.md and HISTORY.md before compaction or session trimming.
 - Workspace MEMORY.md is not updated by normal runtime consolidation.
+- ENVIRONMENT.md is not normal conversational memory. Read it only when environment history or machine state matters.
 
 ### Cold Storage
 - ${channelPath}/log.jsonl is a raw archive. It is not normal memory and is not proactively loaded.
 - ${channelPath}/context.jsonl is a raw session archive. It is not normal memory and is not proactively loaded.
 
 When a task depends on prior decisions, preferences, or long-running work, prefer SESSION.md first for current state, then MEMORY.md, then HISTORY.md.`);
-    sections.push(`## System Configuration Log
-Maintain ${workspacePath}/SYSTEM.md to log all environment modifications:
-- Installed packages (apk add, npm install, pip install)
-- Environment variables set
-- Config files modified
-- Skill dependencies installed
-
-Update this file whenever you modify the environment.`);
+    sections.push(`## Environment Log
+Maintain ${workspacePath}/ENVIRONMENT.md to record durable environment changes when they matter:
+- Installed packages or tools that future work depends on
+- Important environment variables or credential sources
+- Config files modified outside normal project code
+- Runtime prerequisites that affect future sessions
+
+Keep it factual and concise. Do not use it for task progress or conversation summaries.`);
     sections.push(`## Tools
 - read: Read files
 - edit: Surgical file edits

package/dist/agent/workspace-resources.d.ts

@@ -1,6 +1,6 @@
 /**
  * Workspace resource loaders for pipiclaw:
- * SOUL.md, AGENTS.md, and workspace/channel skills.
+ * SOUL.md, AGENTS.md, and workspace-level skills.
  */
 import { type Skill } from "@mariozechner/pi-coding-agent";
 /**
@@ -14,7 +14,6 @@ export declare function getSoul(workspaceDir: string): string;
  */
 export declare function getAgentConfig(channelDir: string): string;
 /**
- * Load skills from both workspace-level and channel-level skill directories.
- * Channel-level skills override global skills with the same name.
+ * Load skills from the workspace-level skill directory only.
  */
 export declare function loadPipiclawSkills(channelDir: string, workspacePath: string): Skill[];

package/dist/agent/workspace-resources.js

@@ -1,6 +1,6 @@
 /**
  * Workspace resource loaders for pipiclaw:
- * SOUL.md, AGENTS.md, and workspace/channel skills.
+ * SOUL.md, AGENTS.md, and workspace-level skills.
  */
 import { loadSkillsFromDir } from "@mariozechner/pi-coding-agent";
 import { existsSync, readFileSync } from "fs";
@@ -44,11 +44,9 @@ export function getAgentConfig(channelDir) {
     return "";
 }
 /**
- * Load skills from both workspace-level and channel-level skill directories.
- * Channel-level skills override global skills with the same name.
+ * Load skills from the workspace-level skill directory only.
  */
 export function loadPipiclawSkills(channelDir, workspacePath) {
-    const skillMap = new Map();
     const hostWorkspacePath = join(channelDir, "..");
     const translatePath = (hostPath) => {
         if (hostPath.startsWith(hostWorkspacePath)) {
@@ -56,19 +54,11 @@ export function loadPipiclawSkills(channelDir, workspacePath) {
         }
         return hostPath;
     };
-    // Load workspace-level skills (global)
     const workspaceSkillsDir = join(hostWorkspacePath, "skills");
-    for (const skill of loadSkillsFromDir({ dir: workspaceSkillsDir, source: "workspace" }).skills) {
+    const skills = loadSkillsFromDir({ dir: workspaceSkillsDir, source: "workspace" }).skills;
+    for (const skill of skills) {
         skill.filePath = translatePath(skill.filePath);
         skill.baseDir = translatePath(skill.baseDir);
-        skillMap.set(skill.name, skill);
     }
-    // Load channel-specific skills
-    const channelSkillsDir = join(channelDir, "skills");
-    for (const skill of loadSkillsFromDir({ dir: channelSkillsDir, source: "channel" }).skills) {
-        skill.filePath = translatePath(skill.filePath);
-        skill.baseDir = translatePath(skill.baseDir);
-        skillMap.set(skill.name, skill);
-    }
-    return Array.from(skillMap.values());
+    return skills;
 }

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export { runSidecarTask, type SidecarResult, type SidecarTask, } from "./memory/
 export { getApiKeyForModel } from "./models/api-keys.js";
 export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
+export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";
 export { type BusyMessageMode, DingTalkBot, type DingTalkConfig, type DingTalkContext, type DingTalkEvent, type DingTalkHandler, } from "./runtime/dingtalk.js";
 export { createEventsWatcher, EventsWatcher, type ImmediateEvent, type OneShotEvent, type PeriodicEvent, type ScheduledEvent, } from "./runtime/events.js";

package/dist/index.js

@@ -13,6 +13,7 @@ export { runSidecarTask, } from "./memory/sidecar-worker.js";
 export { getApiKeyForModel } from "./models/api-keys.js";
 export { findExactModelReferenceMatch, formatModelList, formatModelReference, resolveInitialModel, } from "./models/utils.js";
 export { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, SUB_AGENTS_DIR, SUB_AGENTS_DIR_NAME, WORKSPACE_DIR, } from "./paths.js";
+export { ensureChannelDir, getChannelDir, getChannelDirName, } from "./runtime/channel-paths.js";
 export { createDingTalkContext } from "./runtime/delivery.js";
 export { DingTalkBot, } from "./runtime/dingtalk.js";
 export { createEventsWatcher, EventsWatcher, } from "./runtime/events.js";

package/dist/runtime/bootstrap.js

@@ -6,6 +6,7 @@ import * as log from "../log.js";
 import { ensureChannelMemoryFilesSync } from "../memory/files.js";
 import { APP_HOME_DIR, APP_NAME, AUTH_CONFIG_PATH, CHANNEL_CONFIG_PATH, MODELS_CONFIG_PATH, SETTINGS_CONFIG_PATH, WORKSPACE_DIR, } from "../paths.js";
 import { parseSandboxArg, validateSandbox } from "../sandbox.js";
+import { ensureChannelDir } from "./channel-paths.js";
 import { createDingTalkContext } from "./delivery.js";
 import { DingTalkBot, } from "./dingtalk.js";
 import { createEventsWatcher } from "./events.js";
@@ -68,6 +69,26 @@ This file stores stable workspace-level memory.
 
 <!-- Put long-lived project facts here. -->
 `;
+const DEFAULT_ENVIRONMENT = `# Environment
+
+This file records durable environment facts and notable machine-level changes.
+
+- Record installed tools, runtime prerequisites, and important config changes here.
+- Keep entries concise and factual.
+- Do not use this file for task progress, conversation summaries, or project-specific decisions.
+
+## Environment Facts
+
+<!-- Put stable machine or runtime facts here. -->
+
+## Installed Tools
+
+<!-- Record durable tools or dependencies that were installed for this workspace. -->
+
+## Config Changes
+
+<!-- Record important config or environment changes that affect future work. -->
+`;
 const CHANNEL_CONFIG_TEMPLATE = {
     clientId: "your-dingtalk-client-id",
     clientSecret: "your-dingtalk-client-secret",
@@ -139,6 +160,7 @@ export function bootstrapAppHome(paths = DEFAULT_BOOTSTRAP_PATHS) {
     writeTextFileIfMissing(join(paths.workspaceDir, "SOUL.md"), DEFAULT_SOUL, "workspace/SOUL.md", created);
     writeTextFileIfMissing(join(paths.workspaceDir, "AGENTS.md"), DEFAULT_AGENT, "workspace/AGENTS.md", created);
     writeTextFileIfMissing(join(paths.workspaceDir, "MEMORY.md"), DEFAULT_MEMORY, "workspace/MEMORY.md", created);
+    writeTextFileIfMissing(join(paths.workspaceDir, "ENVIRONMENT.md"), DEFAULT_ENVIRONMENT, "workspace/ENVIRONMENT.md", created);
     const channelTemplateCreated = writeJsonFileIfMissing(paths.channelConfigPath, CHANNEL_CONFIG_TEMPLATE, "channel.json", created);
     writeJsonFileIfMissing(paths.authConfigPath, {}, "auth.json", created);
     writeJsonFileIfMissing(paths.modelsConfigPath, MODELS_CONFIG_TEMPLATE, "models.json", created);
@@ -273,7 +295,7 @@ export async function bootstrap(argv, options = {}) {
     const getState = (channelId) => {
         let state = channelStates.get(channelId);
         if (!state) {
-            const channelDir = join(paths.workspaceDir, channelId);
+            const channelDir = ensureChannelDir(paths.workspaceDir, channelId);
             ensureChannelMemoryFilesSync(channelDir);
             state = {
                 running: false,

package/dist/runtime/channel-paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getChannelDirName(channelId: string): string;
+export declare function getChannelDir(baseDir: string, channelId: string): string;
+export declare function ensureChannelDir(baseDir: string, channelId: string): string;

package/dist/runtime/channel-paths.js

@@ -0,0 +1,13 @@
+import { mkdirSync } from "fs";
+import { join } from "path";
+export function getChannelDirName(channelId) {
+    return channelId.replaceAll("/", "__");
+}
+export function getChannelDir(baseDir, channelId) {
+    return join(baseDir, getChannelDirName(channelId));
+}
+export function ensureChannelDir(baseDir, channelId) {
+    const channelDir = getChannelDir(baseDir, channelId);
+    mkdirSync(channelDir, { recursive: true });
+    return channelDir;
+}

package/dist/runtime/dingtalk.js

@@ -14,6 +14,7 @@ import { dirname, join } from "path";
 import { parseBuiltInCommand, renderBuiltInHelp } from "../agent/commands.js";
 import * as log from "../log.js";
 import { isRecord } from "../shared/type-guards.js";
+import { getChannelDir } from "./channel-paths.js";
 class ChannelQueue {
     constructor() {
         this.queue = [];
@@ -761,6 +762,6 @@ export class DingTalkBot {
     getConversationMetaPath(channelId) {
         if (!this.config.stateDir)
             return null;
-        return join(this.config.stateDir, channelId, ".channel-meta.json");
+        return join(getChannelDir(this.config.stateDir, channelId), ".channel-meta.json");
     }
 }

package/dist/runtime/store.js

@@ -1,6 +1,7 @@
 import { closeSync, existsSync, mkdirSync, openSync, readSync, renameSync, statSync } from "fs";
 import { appendFile, writeFile } from "fs/promises";
 import { dirname, join } from "path";
+import { ensureChannelDir, getChannelDir } from "./channel-paths.js";
 const MAX_LOG_SIZE_BYTES = 1_000_000;
 const DEDUPE_TTL_MS = 60_000;
 const DEDUPE_CLEANUP_INTERVAL_MS = 30_000;
@@ -19,11 +20,7 @@ export class ChannelStore {
      * Get or create the directory for a channel/DM
      */
     getChannelDir(channelId) {
-        const dir = join(this.workingDir, channelId);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        return dir;
+        return ensureChannelDir(this.workingDir, channelId);
     }
     /**
      * Log a message to the channel's log.jsonl raw archive.
@@ -102,7 +99,7 @@ export class ChannelStore {
      * Returns null if no log exists
      */
     getLastTimestamp(channelId) {
-        const logPath = join(this.workingDir, channelId, "log.jsonl");
+        const logPath = join(getChannelDir(this.workingDir, channelId), "log.jsonl");
         if (!existsSync(logPath)) {
             return null;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oyasmi/pipiclaw",
-	"version": "0.5.4",
+	"version": "0.5.5",
 	"description": "An AI assistant runtime for coding and team workflows, with DingTalk AI Cards, sub-agents, memory, and scheduled events.",
 	"type": "module",
 	"bin": {