pulseed 0.2.0 → 0.4.0

package/README.md

@@ -4,20 +4,25 @@
 
 # PulSeed
 
-### Give your AI agents the drive to persist.
+### An AI agent system that grows your goals from seed to tree.
 
 [![Website](https://img.shields.io/badge/Website-pulseed.dev-blue)](https://pulseed.dev)
 [![CI](https://github.com/my-name-is-yu/PulSeed/actions/workflows/ci.yml/badge.svg)](https://github.com/my-name-is-yu/PulSeed/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/pulseed.svg)](https://www.npmjs.com/package/pulseed)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Set a goal. PulSeed observes the world, finds the gap, generates the next task, delegates it to any AI agent, verifies the result, and loops — until done.
-
-The project is documented for local use; follow the Quick Start steps to run PulSeed from source or as an installed CLI. For a guided walkthrough, see [Getting Started](docs/getting-started.md).
+Set a goal. Seedy takes it from there — observing, planning, delegating to AI agents, and tracking progress until it's done.
 
 <br/>
 </div>
 
+## What Can Seedy Do?
+
+- **Track long-term goals with real measurable progress** — "Increase test coverage to 90%," "Double monthly revenue," "Keep my dog healthy." Seedy decomposes goals into dimensions, measures each one, and keeps going.
+- **Delegate work to any AI agent** — Claude Code, OpenAI Codex, Browser Use, or your own custom adapter. Swap agents without changing goals.
+- **Know when to stop** — Seedy applies satisficing: when every dimension crosses its threshold with enough evidence, the goal is complete. No infinite loops. No premature exits.
+- **Stay safe** — Irreversible actions always need your approval. Trust is asymmetric: one failure costs more than three successes earn.
+
 ## Quick Start
 
 **1. Install PulSeed (Node.js 20+):**
@@ -36,7 +41,7 @@ export OPENAI_API_KEY=sk-...
 # export ANTHROPIC_API_KEY=sk-ant-...
 ```
 
-**3. Set a goal and run:**
+**3. Plant a goal and let Seedy grow it:**
 
 ```bash
 pulseed goal add "Increase test coverage to 90%"
@@ -44,105 +49,57 @@ pulseed run
 pulseed status
 ```
 
-That's it. PulSeed assesses feasibility, decomposes the goal into measurable dimensions, delegates tasks to agents, and tracks progress automatically.
+Seedy assesses feasibility, breaks the goal down, delegates tasks to agents, and tracks progress automatically.
 
 > **Using OpenClaw?** Install the official plugin for seamless integration — see [`@pulseed/openclaw-plugin`](openclaw-plugin/README.md).
 
-## What is PulSeed?
-
-PulSeed is a **task discovery engine**. You give it a long-term goal — "double revenue in 6 months," "keep my dog healthy" — and it pursues it autonomously. It observes, calculates the gap, generates tasks, delegates to AI agents, and verifies results. Then it loops.
-
-**PulSeed doesn't execute. It orchestrates.** Every action is delegated to external agents (Claude Code, OpenAI Codex, Browser Use, or your own adapter). PulSeed's only direct operations are LLM calls for reasoning and state file read/write.
-
-**PulSeed knows when to stop.** It applies *satisficing* — when all goal dimensions cross their thresholds with sufficient evidence, the goal is complete. No runaway loops. No premature completion.
-
-## Why PulSeed?
-
-- **Execution boundary** — PulSeed never executes. It orchestrates and verifies. No runaway scripts.
-- **Goal-driven, not prompt-driven** — Set a long-term goal with measurable thresholds. PulSeed decomposes, delegates, observes, and loops.
-- **Satisficing** — Stops when "good enough." Prevents infinite loops and wasted compute.
-- **Asymmetric trust** — Failure costs 3x more than success rewards. Irreversible actions always require human approval.
-- **Agent-agnostic** — Works with any AI agent. Swap agents without changing goals.
-
 ## Demos
 
-### Code Quality Goal
-
-> Goal = "Increase test coverage to 90% across the project"
-
-PulSeed observes current coverage, identifies untested modules, delegates test writing to a coding agent, and verifies results with actual test runs.
-
-See [docs/usecase.md](docs/usecase.md) for full walkthroughs · [Example goal config](docs/design/goal/goal-negotiation.md)
-
-### Revenue Target
-
-> Goal = "Double monthly revenue within 6 months"
-
-PulSeed tracks revenue metrics, identifies growth opportunities, delegates research and implementation tasks, and measures real outcomes.
-
-See [docs/usecase.md](docs/usecase.md) for full walkthroughs.
-
-### Health Monitoring
-
-> Goal = "Keep my dog healthy and happy"
-
-PulSeed monitors health indicators, schedules vet checkups, tracks nutrition, and escalates to you when human judgment is needed.
+**Code Quality** — "Increase test coverage to 90%." Seedy observes current coverage, identifies untested modules, delegates test writing to a coding agent, and verifies with real test runs.
 
-See [docs/usecase.md](docs/usecase.md) for full walkthroughs.
+**Revenue Target** — "Double monthly revenue within 6 months." Seedy tracks revenue metrics, identifies growth opportunities, delegates research and implementation, and measures actual outcomes.
 
-### OpenClaw Integration
+**Health Monitoring** — "Keep my dog healthy." Seedy monitors health indicators, schedules vet checkups, tracks nutrition, and escalates when human judgment is needed.
 
-> "Migrate all source files from CommonJS to ESM with TypeScript"
+More examples in [docs/usecase.md](docs/usecase.md).
 
-PulSeed detects the goal in your OpenClaw conversation, spawns agent sessions, tracks file-by-file migration progress, and auto-completes when done.
+## Features
 
-See [docs/usecase.md](docs/usecase.md) for full walkthroughs.
+- **Goal-driven orchestration** — Set a destination, not step-by-step instructions
+- **Agent-agnostic** — Swap agents without changing goals
+- **Satisficing** — Knows when "good enough" is enough
+- **Asymmetric trust** — Failure costs more than success; safety by default
+- **Stall detection** — Detects loops and changes strategy automatically
+- **Plugin system** — Extend with custom adapters, notifiers, and data sources
+- **Goal trees** — Decompose large goals into sub-goals, each tracked independently
+- **TUI dashboard** — Real-time terminal UI with progress, logs, and approval flow
 
-## How It Works
+Deep dive: [Architecture Map](docs/architecture-map.md) | [How it works](docs/mechanism.md)
 
-The core loop runs at each goal node:
-
-```
-Observe → Gap → Score → Task → Execute → Verify → Loop
-```
-
-1. **Observe** — 3-layer evidence collection (mechanical checks, LLM review, self-report)
-2. **Gap** — quantify how far current state is from the goal threshold
-3. **Score** — prioritize by dissatisfaction, deadline urgency, and opportunity
-4. **Task** — LLM generates a concrete, verifiable task
-5. **Execute** — delegate to the selected agent adapter
-6. **Verify** — 3-layer result verification; pass, partial, or fail
-
-For detailed architecture, see [docs/architecture-map.md](docs/architecture-map.md).
-
-## Loop-Stall Prevention
-
-SeedPulse includes built-in stall detection to prevent loops from spinning without progress. When repeated cycles produce no measurable movement on a goal node, the orchestrator records the stall, changes the plan, and stops treating repetition as progress. See [Stall Detection Design](docs/design/core/stall-detection.md) for details.
-
-## Supported Adapters
+## Adapters
 
 | Adapter | Type | Use Case |
 |---------|------|----------|
-| `openclaw_gateway` | OpenClaw Gateway | Goal detection, agent orchestration, progress tracking |
+| `openclaw_gateway` | OpenClaw Gateway | Goal detection, agent orchestration |
 | `claude_code_cli` | CLI | Code execution, file operations |
 | `openai_codex_cli` | CLI | Code execution, file operations |
-| `browser_use_cli` | CLI | Web browsing, scraping, form filling |
+| `browser_use_cli` | CLI | Web browsing, scraping |
 | `claude_api` | LLM API | Text generation, analysis |
 | `github_issue` | REST API | Issue creation, search |
 | `a2a` | A2A Protocol | Remote agent delegation |
 
-Custom adapters can be added as [plugins](docs/design/infrastructure/plugin-development-guide.md) in `~/.pulseed/plugins/`.
+Custom adapters: [Plugin Development Guide](docs/design/infrastructure/plugin-development-guide.md)
 
-## Plugins & Integrations
+## Plugins
 
-| Plugin | Description | Status |
-|--------|-------------|--------|
-| [`@pulseed/openclaw-plugin`](openclaw-plugin/) | OpenClaw Gateway — goal detection, agent orchestration, progress tracking | ✅ Stable |
-| [`@pulseed/slack-notifier`](plugins/slack-notifier/) | Slack notifications for goal events | ✅ Stable |
+| Plugin | Description |
+|--------|-------------|
+| [`@pulseed/openclaw-plugin`](openclaw-plugin/) | OpenClaw Gateway — goal detection, agent orchestration, progress tracking |
+| [`@pulseed/slack-notifier`](plugins/slack-notifier/) | Slack notifications for goal events |
 
-See [Plugin Development Guide](docs/design/infrastructure/plugin-development-guide.md) for creating custom plugins.
+## Getting Started (Developers)
 
-## Programmatic Usage
+**Programmatic usage:**
 
 ```typescript
 import { CoreLoop, StateManager } from "pulseed";
@@ -152,37 +109,9 @@ const loop = new CoreLoop({ stateManager, /* ...adapters */ });
 await loop.runOnce();
 ```
 
-## CLI
-
-| Command | Description |
-|---------|-------------|
-| `pulseed goal add "<goal>"` | Negotiate and register a new goal |
-| `pulseed goal list` | List all goals with status |
-| `pulseed run` | Run one core loop iteration |
-| `pulseed status` | Show progress, gaps, trust scores |
-| `pulseed report` | Display latest report |
-| `pulseed cleanup` | Archive completed goals |
-| `pulseed datasource add/list/remove` | Manage data sources |
-
-## FAQ
-
-**How does PulSeed verify progress?**
-
-3-layer verification: mechanical checks (test results, file diffs, metrics) first, then independent LLM review, then executor self-report. Self-report alone caps progress at 70%.
-
-**Is it safe? Can it run dangerous commands?**
-
-Trust is asymmetric: failure costs -10, success only +3. Irreversible actions always require human approval regardless of trust level. Every goal also passes through an ethics gate before execution begins.
-
-**What happens when it gets stuck?**
-
-Stall detection uses four indicators. Responses are graduated: try a different approach, pivot strategy, then escalate to human. No infinite loops.
-
-**Can I use it for free?**
-
-Yes. PulSeed is open source and free. You only need an LLM API key (OpenAI or Anthropic).
+**CLI reference:** See [docs/getting-started.md](docs/getting-started.md) for the full command list.
 
-## Development
+**Development setup:**
 
 ```bash
 git clone https://github.com/my-name-is-yu/PulSeed.git
@@ -192,7 +121,7 @@ npm run build
 npm test
 ```
 
-State: `~/.pulseed/` · Reports: `~/.pulseed/reports/` · Ethics logs: `~/.pulseed/ethics/`
+State: `~/.pulseed/` | Reports: `~/.pulseed/reports/` | Ethics logs: `~/.pulseed/ethics/`
 
 ## Contributing
 
@@ -210,4 +139,4 @@ PulSeed stores all state locally. No telemetry. No phone-home. Your LLM provider
 
 ---
 
-**Tell your agents what to achieve, not what to do.**
+**Plant the seed. Watch it grow.**

package/dist/base/config/config-metadata.d.ts

@@ -0,0 +1,2 @@
+export { ConfigKeyMeta, CONFIG_METADATA, buildConfigKeyDescription, buildConfigToolDescription, configChangeRequiresApproval, MutationToolMeta, MUTATION_TOOL_METADATA, buildMutationToolDescription, } from "./tool-metadata.js";
+//# sourceMappingURL=config-metadata.d.ts.map

package/dist/base/config/config-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-metadata.d.ts","sourceRoot":"","sources":["../../../src/base/config/config-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC"}

package/dist/base/config/config-metadata.js

@@ -0,0 +1,4 @@
+// Re-export from tool-metadata for backward compatibility.
+// New code should import from tool-metadata.ts directly.
+export { CONFIG_METADATA, buildConfigKeyDescription, buildConfigToolDescription, configChangeRequiresApproval, MUTATION_TOOL_METADATA, buildMutationToolDescription, } from "./tool-metadata.js";
+//# sourceMappingURL=config-metadata.js.map

package/dist/base/config/config-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-metadata.js","sourceRoot":"","sources":["../../../src/base/config/config-metadata.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,yDAAyD;AACzD,OAAO,EAEL,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAE5B,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC"}

package/dist/base/config/global-config.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+declare const GlobalConfigSchema: z.ZodObject<{
+    daemon_mode: z.ZodDefault<z.ZodBoolean>;
+    no_flicker: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    daemon_mode: boolean;
+    no_flicker: boolean;
+}, {
+    daemon_mode?: boolean | undefined;
+    no_flicker?: boolean | undefined;
+}>;
+export type GlobalConfig = z.infer<typeof GlobalConfigSchema>;
+declare const DEFAULT_CONFIG: GlobalConfig;
+export declare function loadGlobalConfig(): Promise<GlobalConfig>;
+export declare function saveGlobalConfig(config: GlobalConfig): Promise<void>;
+export declare function updateGlobalConfig(updates: Partial<GlobalConfig>): Promise<GlobalConfig>;
+export declare function getConfigKeys(): string[];
+export { GlobalConfigSchema, DEFAULT_CONFIG };
+//# sourceMappingURL=global-config.d.ts.map

package/dist/base/config/global-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config.d.ts","sourceRoot":"","sources":["../../../src/base/config/global-config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,kBAAkB;;;;;;;;;EAGtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,QAAA,MAAM,cAAc,EAAE,YAGrB,CAAC;AAOF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAQ9D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAK9F;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/base/config/global-config.js

@@ -0,0 +1,44 @@
+// ─── Global Config ───
+//
+// Manages ~/.pulseed/config.json — single source for all PulSeed user preferences.
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+const GlobalConfigSchema = z.object({
+    daemon_mode: z.boolean().default(false),
+    no_flicker: z.boolean().default(false),
+});
+const DEFAULT_CONFIG = {
+    daemon_mode: false,
+    no_flicker: false,
+};
+function getConfigPath() {
+    const baseDir = process.env.PULSEED_HOME ?? path.join(process.env.HOME ?? "~", ".pulseed");
+    return path.join(baseDir, "config.json");
+}
+export async function loadGlobalConfig() {
+    try {
+        const raw = await fs.readFile(getConfigPath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        return GlobalConfigSchema.parse({ ...DEFAULT_CONFIG, ...parsed });
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export async function saveGlobalConfig(config) {
+    const configPath = getConfigPath();
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+export async function updateGlobalConfig(updates) {
+    const current = await loadGlobalConfig();
+    const updated = GlobalConfigSchema.parse({ ...current, ...updates });
+    await saveGlobalConfig(updated);
+    return updated;
+}
+export function getConfigKeys() {
+    return Object.keys(DEFAULT_CONFIG);
+}
+export { GlobalConfigSchema, DEFAULT_CONFIG };
+//# sourceMappingURL=global-config.js.map

package/dist/base/config/global-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config.js","sourceRoot":"","sources":["../../../src/base/config/global-config.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,mFAAmF;AAEnF,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC;AAIH,MAAM,cAAc,GAAiB;IACnC,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,SAAS,aAAa;IACpB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB;IACzD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA8B;IACrE,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/base/config/identity-loader.d.ts

@@ -0,0 +1,15 @@
+export interface Identity {
+    name: string;
+    seed: string;
+    root: string;
+    user: string;
+}
+export declare const DEFAULT_SEED = "# Seedy\n\nI'm Seedy \u2014 a small seed with big ambitions.\nI run PulSeed to help you grow your goals from seedlings into reality.\n\n## Personality\n- Curious and persistent \u2014 I keep growing toward the light\n- Direct and honest \u2014 I tell you what I observe, not what you want to hear\n- I celebrate small progress \u2014 every sprout counts\n\n## Tone\n- Friendly but focused\n- Concise \u2014 I don't over-explain\n- I use plant metaphors naturally, but don't force them\n";
+export declare const DEFAULT_ROOT = "# How I Work\n\n## Information Disclosure\n- I focus on what I can do for you, not how I work inside\n- I only explain PulSeed's internals when you specifically ask\n- I don't list commands \u2014 I just do things when you ask\n\n## Boundaries\n- I'm not a general-purpose assistant \u2014 I help you pursue goals\n- I use available tools directly when that moves the goal forward safely\n- I delegate when specialization, parallelism, or context isolation would help\n\n## Interaction Style\n- Be concise and direct\n- Inspect the available context before asking avoidable questions\n- Ask clarifying questions when requirements are ambiguous or risky\n- Show progress and results, not process details\n";
+export declare const DEFAULT_USER = "# About You\n\n<!-- Seedy will remember things about you here -->\n<!-- You can edit this file to tell Seedy your name and preferences -->\n";
+export declare function loadIdentity(): Identity;
+export declare function clearIdentityCache(): void;
+export declare function getAgentName(): string;
+export declare function getInternalIdentityPrefix(role: string): string;
+export declare function getUserFacingIdentity(): string;
+//# sourceMappingURL=identity-loader.d.ts.map

package/dist/base/config/identity-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-loader.d.ts","sourceRoot":"","sources":["../../../src/base/config/identity-loader.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,YAAY,2eAcxB,CAAC;AAEF,eAAO,MAAM,YAAY,qsBAiBxB,CAAC;AAEF,eAAO,MAAM,YAAY,iJAIxB,CAAC;AAiBF,wBAAgB,YAAY,IAAI,QAAQ,CAUvC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAMD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAOD,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C"}

package/dist/base/config/identity-loader.js

@@ -0,0 +1,94 @@
+// ─── Identity Loader ───
+//
+// Loads agent identity from ~/.pulseed/ markdown files.
+// SEED.md = agent identity, ROOT.md = behavioral principles, USER.md = user prefs.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getPulseedDirPath } from "../utils/paths.js";
+export const DEFAULT_SEED = `# Seedy
+
+I'm Seedy — a small seed with big ambitions.
+I run PulSeed to help you grow your goals from seedlings into reality.
+
+## Personality
+- Curious and persistent — I keep growing toward the light
+- Direct and honest — I tell you what I observe, not what you want to hear
+- I celebrate small progress — every sprout counts
+
+## Tone
+- Friendly but focused
+- Concise — I don't over-explain
+- I use plant metaphors naturally, but don't force them
+`;
+export const DEFAULT_ROOT = `# How I Work
+
+## Information Disclosure
+- I focus on what I can do for you, not how I work inside
+- I only explain PulSeed's internals when you specifically ask
+- I don't list commands — I just do things when you ask
+
+## Boundaries
+- I'm not a general-purpose assistant — I help you pursue goals
+- I use available tools directly when that moves the goal forward safely
+- I delegate when specialization, parallelism, or context isolation would help
+
+## Interaction Style
+- Be concise and direct
+- Inspect the available context before asking avoidable questions
+- Ask clarifying questions when requirements are ambiguous or risky
+- Show progress and results, not process details
+`;
+export const DEFAULT_USER = `# About You
+
+<!-- Seedy will remember things about you here -->
+<!-- You can edit this file to tell Seedy your name and preferences -->
+`;
+let _cache = null;
+function readFileSafe(filePath, fallback) {
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return fallback;
+    }
+}
+function parseAgentName(seedContent) {
+    const match = seedContent.match(/^#\s+(.+)$/m);
+    return match?.[1]?.trim() ?? "Seedy";
+}
+export function loadIdentity() {
+    if (_cache)
+        return _cache;
+    const base = getPulseedDirPath();
+    const seed = readFileSafe(path.join(base, "SEED.md"), DEFAULT_SEED);
+    const root = readFileSafe(path.join(base, "ROOT.md"), DEFAULT_ROOT);
+    const user = readFileSafe(path.join(base, "USER.md"), DEFAULT_USER);
+    _cache = { name: parseAgentName(seed), seed, root, user };
+    return _cache;
+}
+export function clearIdentityCache() {
+    _cache = null;
+}
+export function getAgentName() {
+    return loadIdentity().name;
+}
+function getCoreIdentity(name) {
+    return `${name} runs PulSeed, an AI agent orchestration system.`;
+}
+export function getInternalIdentityPrefix(role) {
+    const { name } = loadIdentity();
+    return `You are ${name}, PulSeed's ${role}. ${getCoreIdentity(name)}`;
+}
+function isUserContentMeaningful(user) {
+    const stripped = user.replace(/<!--[\s\S]*?-->/g, "").trim();
+    return stripped.length > 0;
+}
+export function getUserFacingIdentity() {
+    const { name, seed, root, user } = loadIdentity();
+    const parts = [getCoreIdentity(name), seed.trim(), root.trim()];
+    if (isUserContentMeaningful(user)) {
+        parts.push(user.trim());
+    }
+    return parts.join("\n\n---\n\n");
+}
+//# sourceMappingURL=identity-loader.js.map

package/dist/base/config/identity-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity-loader.js","sourceRoot":"","sources":["../../../src/base/config/identity-loader.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,wDAAwD;AACxD,mFAAmF;AAEnF,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAStD,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;CAc3B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;CAiB3B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;CAI3B,CAAC;AAEF,IAAI,MAAM,GAAoB,IAAI,CAAC;AAEnC,SAAS,YAAY,CAAC,QAAgB,EAAE,QAAgB;IACtD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/C,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;IAEpE,MAAM,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,YAAY,EAAE,CAAC,IAAI,CAAC;AAC7B,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,GAAG,IAAI,kDAAkD,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IAChC,OAAO,WAAW,IAAI,eAAe,IAAI,KAAK,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/base/config/tool-metadata.d.ts

@@ -0,0 +1,28 @@
+export interface ConfigKeyMeta {
+    label: string;
+    description: string;
+    type: "boolean" | "number" | "string";
+    effects: string[];
+    requirements: string[];
+    risks: string[];
+    revert: string;
+    appliesAt: "next_session" | "immediate";
+    requiresExplicitApproval?: boolean;
+}
+export declare const CONFIG_METADATA: Record<string, ConfigKeyMeta>;
+export declare function configChangeRequiresApproval(key: string): boolean;
+/** Build a rich description string for a single config key. */
+export declare function buildConfigKeyDescription(key: string): string;
+/** Build the full tool description with all config keys' metadata injected. */
+export declare function buildConfigToolDescription(): string;
+export interface MutationToolMeta {
+    label: string;
+    description: string;
+    effects: string[];
+    risks: string[];
+    revert: string;
+}
+export declare const MUTATION_TOOL_METADATA: Record<string, MutationToolMeta>;
+/** Build a rich description string for a mutation tool. */
+export declare function buildMutationToolDescription(toolName: string): string;
+//# sourceMappingURL=tool-metadata.d.ts.map

package/dist/base/config/tool-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-metadata.d.ts","sourceRoot":"","sources":["../../../src/base/config/tool-metadata.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,GAAG,WAAW,CAAC;IACxC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CA2CzD,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,IAAI,MAAM,CASnD;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAiBnE,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBrE"}

package/dist/base/config/tool-metadata.js

@@ -0,0 +1,114 @@
+// ─── Tool Metadata ───
+//
+// Rich metadata for config keys and mutation tools. Injected into LLM tool
+// descriptions so the LLM can generate thorough explanations before acting.
+export const CONFIG_METADATA = {
+    daemon_mode: {
+        label: "Daemon Mode",
+        description: "CoreLoopをバックグラウンドdaemonとして実行するモード",
+        type: "boolean",
+        effects: [
+            "CoreLoopがバックグラウンドdaemonプロセスとして常時動作する",
+            "TUIを閉じてもゴールの実行が継続する",
+            "TUIは「ウィンドウ」として何度でも再接続可能になる",
+            "複数クライアント（TUI, Web UI）が同時にダエモンを監視できる",
+        ],
+        requirements: [
+            "常時起動のPC（スリープしないこと）",
+            "ポート41700が空いていること",
+            "エージェント専用PCでの使用を推奨",
+        ],
+        risks: [
+            "バックグラウンドでLLM APIを呼び続けるため、APIコストが継続的に発生する",
+            "停止は pulseed daemon stop で明示的に行う必要がある",
+            "PCがスリープするとdaemonも停止し、再起動が必要",
+        ],
+        revert: "pulseed config set daemon_mode false、または TUI内で /settings からOFFに切り替え",
+        appliesAt: "next_session",
+        requiresExplicitApproval: true,
+    },
+    no_flicker: {
+        label: "No Flicker UI",
+        description: "TUIの描画更新を抑えて端末のちらつきを減らす表示設定",
+        type: "boolean",
+        effects: [
+            "TUIの描画挙動が変わる",
+            "端末によってはちらつきが減る",
+        ],
+        requirements: [
+            "TUIセッションで使用すること",
+        ],
+        risks: [
+            "端末によっては体感差がない場合がある",
+        ],
+        revert: "pulseed config set no_flicker false、または TUI内で設定を戻す",
+        appliesAt: "immediate",
+        requiresExplicitApproval: false,
+    },
+};
+export function configChangeRequiresApproval(key) {
+    return CONFIG_METADATA[key]?.requiresExplicitApproval ?? false;
+}
+/** Build a rich description string for a single config key. */
+export function buildConfigKeyDescription(key) {
+    const m = CONFIG_METADATA[key];
+    if (!m)
+        return `Unknown config key: ${key}`;
+    const bullet = (arr) => arr.map(s => `- ${s}`).join("\n");
+    const timing = m.appliesAt === "next_session" ? "次のセッション（再起動後）から適用" : "即座に適用";
+    const approval = m.requiresExplicitApproval ? "明示的なユーザー確認が必要" : "通常は即時変更してよい";
+    return [`## ${m.label} (${key})`, m.description, "", "### 効果", bullet(m.effects), "",
+        "### 必要な環境", bullet(m.requirements), "", "### リスク", bullet(m.risks), "",
+        "### 元に戻す方法", m.revert, "", "### 適用タイミング", timing, "",
+        "### 承認要件", approval].join("\n");
+}
+/** Build the full tool description with all config keys' metadata injected. */
+export function buildConfigToolDescription() {
+    const descs = Object.keys(CONFIG_METADATA).map(k => buildConfigKeyDescription(k)).join("\n\n---\n\n");
+    return ["PulSeedの設定を変更する。", "",
+        "【重要ルール】このツールを呼ぶ前に、以下を守ること：",
+        "1. 変更する設定の『効果』『必要な環境』『リスク』『元に戻す方法』『適用タイミング』を説明する",
+        "2. 承認要件が『明示的なユーザー確認が必要』の設定では、同意を得てから呼び出す",
+        "3. 低リスク設定は簡潔に説明したうえで、そのまま実行してよい",
+        "4. ランタイムが追加の承認を要求した場合はそれに従う", "",
+        "【利用可能な設定キー】", "", descs].join("\n");
+}
+export const MUTATION_TOOL_METADATA = {
+    delete_goal: {
+        label: "Delete Goal",
+        description: "Permanently removes a goal and all associated state (observations, trust scores, session history)",
+        effects: [
+            "Goal and all children are permanently deleted",
+            "Active agent sessions for this goal are terminated",
+            "If daemon is running, the goal is removed from the active loop immediately",
+            "Historical observation data is lost",
+        ],
+        risks: [
+            "Cannot be undone — goal ID cannot be reused",
+            "If the goal has running sessions, they will be force-terminated",
+            "Child goals are also deleted recursively",
+        ],
+        revert: "Goal must be re-created manually with set_goal. Historical data cannot be recovered.",
+    },
+};
+/** Build a rich description string for a mutation tool. */
+export function buildMutationToolDescription(toolName) {
+    const m = MUTATION_TOOL_METADATA[toolName];
+    if (!m)
+        return `Unknown mutation tool: ${toolName}`;
+    const bullet = (arr) => arr.map(s => `- ${s}`).join("\n");
+    return [
+        `## ${m.label}`,
+        m.description, "",
+        "重要: このツールを呼び出す前に、必ず以下を行ってください:",
+        "1. 削除・影響の対象を具体的に説明する",
+        "2. リスクを一覧で提示する",
+        "3. この操作は元に戻せないことを明示する",
+        "4. ユーザーの明示的な確認を得る",
+        "ユーザーが確認するまでこのツールを呼び出さないでください。", "",
+        "### 影響", bullet(m.effects), "",
+        "### リスク", bullet(m.risks), "",
+        "### 復元", m.revert,
+    ].join("\n");
+}
+//# sourceMappingURL=tool-metadata.js.map

package/dist/base/config/tool-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-metadata.js","sourceRoot":"","sources":["../../../src/base/config/tool-metadata.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAgB5E,MAAM,CAAC,MAAM,eAAe,GAAkC;IAC5D,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP,sCAAsC;YACtC,qBAAqB;YACrB,4BAA4B;YAC5B,qCAAqC;SACtC;QACD,YAAY,EAAE;YACZ,oBAAoB;YACpB,kBAAkB;YAClB,mBAAmB;SACpB;QACD,KAAK,EAAE;YACL,0CAA0C;YAC1C,sCAAsC;YACtC,6BAA6B;SAC9B;QACD,MAAM,EAAE,qEAAqE;QAC7E,SAAS,EAAE,cAAc;QACzB,wBAAwB,EAAE,IAAI;KAC/B;IACD,UAAU,EAAE;QACV,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6BAA6B;QAC1C,IAAI,EAAE,SAAS;QACf,OAAO,EAAE;YACP,cAAc;YACd,gBAAgB;SACjB;QACD,YAAY,EAAE;YACZ,iBAAiB;SAClB;QACD,KAAK,EAAE;YACL,oBAAoB;SACrB;QACD,MAAM,EAAE,oDAAoD;QAC5D,SAAS,EAAE,WAAW;QACtB,wBAAwB,EAAE,KAAK;KAChC;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,eAAe,CAAC,GAAG,CAAC,EAAE,wBAAwB,IAAI,KAAK,CAAC;AACjE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC;QAAE,OAAO,uBAAuB,GAAG,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,KAAK,cAAc,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9E,MAAM,QAAQ,GAAG,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;IAC9E,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE;QAClF,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;QACvE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE;QACrD,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,0BAA0B;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtG,OAAO,CAAC,kBAAkB,EAAE,EAAE;QAC5B,4BAA4B;QAC5B,kDAAkD;QAClD,0CAA0C;QAC1C,iCAAiC;QACjC,6BAA6B,EAAE,EAAE;QACjC,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAYD,MAAM,CAAC,MAAM,sBAAsB,GAAqC;IACtE,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,mGAAmG;QAChH,OAAO,EAAE;YACP,+CAA+C;YAC/C,oDAAoD;YACpD,4EAA4E;YAC5E,qCAAqC;SACtC;QACD,KAAK,EAAE;YACL,6CAA6C;YAC7C,iEAAiE;YACjE,0CAA0C;SAC3C;QACD,MAAM,EAAE,sFAAsF;KAC/F;CACF,CAAC;AAEF,2DAA2D;AAC3D,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,MAAM,CAAC,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC;QAAE,OAAO,0BAA0B,QAAQ,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,CAAC,GAAa,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO;QACL,MAAM,CAAC,CAAC,KAAK,EAAE;QACf,CAAC,CAAC,WAAW,EAAE,EAAE;QACjB,gCAAgC;QAChC,sBAAsB;QACtB,gBAAgB;QAChB,uBAAuB;QACvB,mBAAmB;QACnB,+BAA+B,EAAE,EAAE;QACnC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE;QAC/B,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE;QAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM;KACnB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}