@xl0/pi-lovely-agents 0.1.0

package/node_modules/@xl0/pi-lovely-config/CHANGELOG.md

@@ -0,0 +1,79 @@
+# Changelog
+
+Historical release dates use npm publication dates (UTC).
+
+## [Unreleased]
+
+## [0.1.3] - 2026-09-06
+
+### Added
+
+- Multi-enum fields with whole-array scope overrides and searchable TUI
+  checklists. Space toggles items, Enter saves, Esc discards; selected items
+  float to the top.
+
+### Changed
+
+- Releases now stage on npm through GitHub Actions with OIDC provenance,
+  then publish after manual 2FA approval.
+
+## [0.1.2] - 2026-07-21
+
+### Fixed
+
+- Malformed JSON and non-object config files now load as empty patches with
+  scope/path warnings instead of throwing. Subsequent updates replace malformed
+  content with valid config.
+
+### Changed
+
+- File-level warnings omit `key`; field-level warnings still include it.
+- Expanded installation, field metadata, and TUI interaction documentation.
+
+## [0.1.1] - 2026-07-08
+
+### Added
+
+- Searchable enum pickers via `search: true`, with inline fuzzy matching
+  against values and descriptions.
+- `field.text()` for multiline strings, with an inline TUI editor:
+  Enter saves, Shift+Enter inserts a newline, Esc discards.
+
+### Fixed
+
+- Single-line string fields reject multiline defaults and values; use text
+  fields for multiline content.
+
+## [0.1.0] - 2026-06-28
+
+### Changed
+
+- Replaced `defineScopedConfigSpec()` and `ScopedConfigState` with
+  `defineScopedConfig({ schema })` and typed `field` builders. Schema object
+  keys define config keys, and labels default to those keys.
+- Unified loading, scoped patches, resolved values, warnings, key-level
+  updates, and scope resets on one stateful config object.
+- Invalid known values now warn and are skipped during resolution;
+  `update()` rejects invalid values while preserving unrelated file contents.
+- Simplified TUI editing controls and default/user/workspace source notes.
+- Trimmed root type exports to `ConfigFromSchema`, `ConfigScope`, and
+  `ScopedConfig`.
+
+### Removed
+
+- TypeBox schema dependency; the library has no runtime dependencies.
+
+## [0.0.1] - 2026-06-23
+
+### Added
+
+- Initial scoped config library with user/workspace JSON storage, defaults,
+  fixed workspace precedence, and optional single-scope restriction.
+- Enum, boolean, string, and number fields, including ranged numbers and
+  explicit numeric choices.
+- Field validation, numeric range warnings, unknown-property preservation,
+  and deletion of empty config files.
+- TUI editor with scope selection, include toggles, resets, descriptions,
+  conditional visibility, inline string/number editing, and live numeric
+  validation.
+- Manual demo extension and usage documentation.

package/node_modules/@xl0/pi-lovely-config/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexey Zaytsev <alexey.zaytsev@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/@xl0/pi-lovely-config/README.md

@@ -0,0 +1,200 @@
+# pi-lovely-config
+
+Scoped config helpers for Pi extension packages.
+
+Define a flat schema once. Get fixed user/workspace files, typed defaults,
+merge semantics, validation warnings, key updates, and an optional TUI editor.
+
+## Install
+
+```sh
+npm i @xl0/pi-lovely-config
+```
+
+No extra runtime dependencies.
+
+## Quick start
+
+```ts
+import {
+	defineScopedConfig,
+	field
+} from "@xl0/pi-lovely-config"
+
+const config = defineScopedConfig({
+	fileName: "vibes.json",
+	schema: {
+		mood: field.enum(["calm", "spicy", "feral"], "calm"),
+		temperature: field.number(0.7, { min: 0, max: 2, step: 0.1 }),
+		signature: field.string("sent from pi"),
+		instructions: field.text("Keep replies concise.")
+	}
+})
+
+config.load(process.cwd())
+console.log(config.value.mood, config.value.temperature)
+
+config.update("workspace", "temperature", 1.1)
+```
+
+## Model
+
+Scopes are fixed:
+
+| Scope | Path |
+| --- | --- |
+| User | `~/.pi/agent/<fileName>` |
+| Workspace | `<cwd>/.pi/<fileName>` |
+
+By default both scopes are active and workspace overrides user. Pass
+`scope: "user"` or `scope: "workspace"` to `defineScopedConfig` for
+single-scope configs.
+
+Unknown keys are preserved in files but ignored by typed config resolution. This
+lets newer config files survive older app versions.
+
+Invalid known values, invalid JSON, and non-object config files are warnings and
+are ignored while resolving. Writing a key replaces a malformed file with valid
+config.
+
+## Schema
+
+Use field builders:
+
+```ts
+const config = defineScopedConfig({
+	fileName: "my-extension.json",
+	schema: {
+		theme: field.enum(["system", "light", "dark"], "system", {
+			label: "Theme",
+			description: "Preferred theme",
+			search: true
+		}),
+		compact: field.boolean(false),
+		signature: field.string("sent from pi"),
+		instructions: field.text("Keep replies concise.", {
+			label: "Instructions",
+			description: "Long multi-line text edited in the TUI editor"
+		}),
+		temperature: field.number(0.7, { min: 0, max: 2, step: 0.1 }),
+		retries: field.number(1, { values: [0, 1, 2, 3] }),
+		models: field.multiEnum(["gpt", "claude", "gemini"], ["claude"])
+	}
+})
+```
+
+Supported fields: enum, multiEnum, boolean, string, text, number. Multi-enum
+fields resolve to a string array; scopes replace the whole array, no merging.
+The TUI editor always opens a searchable checklist for them. String fields are
+single-line. Text fields resolve to string values and use a multi-line TUI
+editor. Number fields take either range mode (`min`/`max`/`step`) or an
+explicit `values` list, never both.
+
+UI-only metadata:
+
+- `label` — display name; defaults to the key
+- `description` — help text shown with the field
+- `valueDescriptions` — per-value help, e.g. `{ dark: "Easy on the eyes" }`
+- `search` — enum fields only; enables fuzzy picker in the TUI editor
+- `depth` — indent level, for visually nesting fields under a parent
+- `visibleWhen: ctx => boolean` — hide the field in the editor based on other
+  values (`ctx.get(key)`, `ctx.getScoped(key, scope?)`, `ctx.scope`). UI-only:
+  hidden saved values persist until cleared.
+
+## Runtime API
+
+```ts
+config.load(ctx.cwd)
+```
+
+`config` now contains:
+
+- `value` — defaults-filled merged config
+- `scoped` — raw user/workspace patches, including unknown keys
+- `warnings` — invalid field or malformed file warnings by scope/path; field warnings include `key`
+
+Update one key:
+
+```ts
+config.update("user", "theme", "dark")
+```
+
+Unset one key:
+
+```ts
+config.update("workspace", "theme", undefined)
+```
+
+Delete one scope config file:
+
+```ts
+config.resetScope("workspace")
+```
+
+Other useful properties/methods:
+
+- `config.fields` — normalized field list for UI
+- `config.defaults` — schema defaults as a plain object
+- `config.path(scope)` — resolved file path for a scope
+- `config.resolve(scoped)` — merge defaults + scope patches without file IO
+
+## TUI editor
+
+```ts
+config.load(ctx.cwd)
+
+await ctx.ui.custom<void>((tui, theme, _keys, done) => {
+	return new ScopedConfigEditor({
+		tui,
+		theme,
+		config,
+		onChange: config => {
+			ctx.ui.setStatus("vibes", `mood=${config.value.mood}`)
+		},
+		done
+	})
+})
+```
+
+Each row shows an include checkbox and a value, plus compact
+default/user/workspace source notes. Left/right moves focus, Enter edits or
+cycles values, Space toggles include, Esc discards uncommitted input.
+
+Editor writes via `update()` / `resetScope()`, then reloads merged config.
+
+## Releasing
+
+Write entries under `CHANGELOG.md`'s `[Unreleased]`, then commit them.
+From `master`, with Bun 1.3.13 and npm 12.0.2 (logged in):
+
+```sh
+bun run release [patch|minor|major|x.y.z] [--no-push]
+```
+
+The script checks the release, bumps the version, rolls the changelog, and
+pauses for review before committing, tagging, and pushing. `--no-push`
+stops after the local commit and tag.
+
+The tag triggers `.github/workflows/publish.yml`: checks, npm staging with
+OIDC provenance, then a GitHub Release. The script waits for staging and
+asks for a 2FA code to approve publication; approval is also available on
+npmjs.com.
+
+Configure npm's GitHub Actions trusted publisher for `xl0/pi-lovely-config`,
+workflow `publish.yml`, environment `npm`. The GitHub job uses that environment.
+No npm token is needed in CI.
+
+## Related projects
+
+|  |  |
+| --- | --- |
+| [Pi Lovely Web](https://github.com/xl0/pi-lovely-web) | `web_search`, `web_fetch`, `web_image` tools |
+| [Pi Lovely Dev Tools](https://github.com/xl0/pi-lovely-dev-tools) | `/tool`, `/show-sysprompt`, `/show-context`, `/llm-stats` |
+| [Pi Lovely Codex](https://github.com/xl0/pi-lovely-codex) | GPT fast mode and Codex-style `apply_patch` |
+| [Pi Lovely IDE](https://github.com/xl0/pi-lovely-ide) | Interactive IDE integration |
+| [Pi Lovely Comment](https://github.com/xl0/agent-files/tree/master/pi/packages/pi-lovely-comment) | Open the last assistant message in your editor and sync edits back into the prompt |
+| [Pi Lovely Rename](https://github.com/xl0/agent-files/tree/master/pi/packages/pi-lovely-rename) | Automatic and manual session naming |
+
+---
+
+Like this work? [Hire me](https://alexey.work/cv?ref=pi-lovely-config)

package/node_modules/@xl0/pi-lovely-config/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "@xl0/pi-lovely-config",
+	"version": "0.1.3",
+	"description": "Scoped config helpers for Pi extension packages",
+	"license": "MIT",
+	"type": "module",
+	"publisher": "xl0",
+	"author": {
+		"name": "Alexey Zaytsev",
+		"url": "https://github.com/xl0",
+		"email": "alexey.zaytsev@gmail.com"
+	},
+	"homepage": "https://github.com/xl0/pi-lovely-config#readme",
+	"bugs": {
+		"url": "https://github.com/xl0/pi-lovely-config/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/xl0/pi-lovely-config.git"
+	},
+	"packageManager": "bun@1.3.13",
+	"keywords": [
+		"pi",
+		"config",
+		"extensions",
+		"library"
+	],
+	"files": [
+		"src/",
+		"README.md",
+		"CHANGELOG.md",
+		"LICENSE"
+	],
+	"exports": {
+		".": "./src/index.ts"
+	},
+	"scripts": {
+		"typecheck": "tsgo --noEmit",
+		"check": "bun run typecheck && bun run biome:check",
+		"prepublishOnly": "bun run check",
+		"release": "bun run scripts/release.ts",
+		"lint": "biome lint .",
+		"format": "biome format --write .",
+		"format:check": "biome format .",
+		"biome:check": "biome check ."
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.14",
+		"@earendil-works/pi-coding-agent": "^0.79.10",
+		"@earendil-works/pi-tui": "^0.79.10",
+		"@typescript/native-preview": "^7.0.0-dev.20260502.1",
+		"bun-types": "^1.3.13",
+		"typescript": "^6.0.3"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*"
+	}
+}