@lolkda/dsh-prompt-manager 3.0.0

package/cordis.patch.yml

@@ -0,0 +1,20 @@
+# The dsh-prompt-manager bundle patch: mounting this package is one insert.
+#
+# A profile that installs this package gains this row automatically — `dsh plugin
+# add` (and any other install path) reconciles `dsh.profile.bundles` against the
+# installed dependencies, and a dependency whose manifest declares
+# `dsh.bundle.patch` joins the layer stack. The row mounts the Host half, which is
+# also what makes the browser half load: the client module system serves the
+# `exports["./client"]` bundle of every package that declares `dsh.client` *and* is
+# an active Loader entry.
+#
+# No `config` here on purpose: the plugin's own defaults (machine-environment facts
+# registered as variables) are what a fresh install wants. Disable or repoint them
+# in the profile's own cordis.patch.yml, which applies after every bundle layer.
+#
+# The entry id is plugin-owned and must not collide with another registry entry's
+# entry IDs, so it is the package's own name rather than the bare `prompt-manager`.
+
+- insert:
+    - id: dsh-prompt-manager
+      name: '@lolkda/dsh-prompt-manager'

package/environment.md

@@ -0,0 +1,24 @@
+# Machine environment
+
+Detected on the machine running the DSH host process, and refreshed whenever the prompt plugin mounts. Every value below is measured rather than assumed — when one of them conflicts with what you observe, trust the observation.
+
+## System
+
+- {{os}}, release `{{os_release}}` (`{{platform}}` / `{{arch}}`)
+
+## Shells
+
+- **bash** `{{bash}}` — write POSIX syntax: `&&`, `$VAR`, forward slashes.
+- **PowerShell** `pwsh` `{{pwsh}}`
+  - Use PowerShell 7 or newer. Windows PowerShell 5.1 is not UTF-8 by default — file writes go through the system ANSI code page, and what it pipes to native programs differs as well — so non-ASCII text is mangled or fails outright. Do not fall back to it.
+  - A value of `(not installed)` above means this machine has no usable PowerShell; that is not a reason to reach for 5.1.
+
+## Version control
+
+- **git** `{{git}}`
+- A repository with no committer identity fails its first commit with `unable to auto-detect email`. Check before committing (`git config user.email`), and where the repository already has commits, reuse their author rather than inventing one.
+
+## Languages
+
+- **Node** `{{node}}`
+- **Python** `{{python}}` — the command is normally `python`. On Windows `python3` may be an App Execution Alias stub that starts, prints nothing, and reports no error, so a silent `python3 --version` is not evidence that Python is missing.

package/lib/entries.js

@@ -0,0 +1,303 @@
+/**
+ * The prompt index: entry identity and the settings schema that carries one
+ * section per entry.
+ *
+ * An entry's markdown body lives in one file per entry under the store
+ * directory; everything else about it — title, order, whether it is injected —
+ * lives in the `prompt-manager` settings namespace this module describes. Keeping
+ * the index in the settings document means the browser gets reads, writes,
+ * revision fencing, and the "user overrode this" flag from the shared settings
+ * transport, while the bodies stay plain `.md` files a person can edit directly.
+ * The same namespace carries the presets: named selections that decide injection
+ * on their own while one of them is active, so a single `activePreset` write
+ * swaps the whole set without touching any entry.
+ *
+ * Entry bodies live either as plain `.md` files a person can edit directly, or
+ * as one markdown file shipped with this package: a fresh install starts with
+ * the built-in machine-environment prompt, and anything a person writes or
+ * subscribes overrides it.
+ *
+ * @module @lolkda/dsh-prompt-manager/entries
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/** Order handed to the first entry a person adds; later additions sort after it. */
+export const USER_ORDER_START = 30;
+/** At most this many entries may be active at once. */
+export const MAX_ENTRIES = 50;
+/** At most this many presets may be configured. */
+export const MAX_PRESETS = 20;
+/** At most this many entries one preset may select. */
+export const MAX_PRESET_ENTRIES = MAX_ENTRIES;
+/** Ref a source starts on when the settings page names none. */
+export const DEFAULT_SOURCE_REF = 'main';
+/** Largest accepted body, in bytes. */
+export const MAX_BODY_BYTES = 256 * 1024;
+/** Largest accepted title, in characters. */
+export const MAX_TITLE_LENGTH = 120;
+/** Largest accepted id, in characters. */
+export const MAX_ID_LENGTH = 64;
+/**
+ * Entry id grammar. The id becomes a file name and a prompt-section name
+ * suffix, so it stays lowercase, hyphenated, and path-safe by construction.
+ */
+export const ENTRY_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+/** The prompts this package ships. */
+export const BUILTIN_PROMPTS = [
+    {
+        id: 'env',
+        title: '机器环境',
+        order: 5,
+        file: new URL('../environment.md', import.meta.url),
+    },
+];
+/**
+ * The base layer's entries: one per {@link BUILTIN_PROMPTS} entry, enabled.
+ *
+ * They behave like any other entry — the page lists them, a write overrides
+ * them, a toggle disables them — so the built-in prose is a starting point
+ * rather than something the deployment cannot reach.
+ *
+ * @returns fresh entry records, safe to hand to a settings base layer.
+ */
+export function builtinEntries() {
+    return BUILTIN_PROMPTS.map((prompt) => ({
+        id: prompt.id,
+        title: prompt.title,
+        order: prompt.order,
+        enabled: true,
+    }));
+}
+/**
+ * The packaged body for one entry id.
+ * @param id - entry id to look up.
+ * @returns the exact UTF-8 markdown, or `undefined` when the package ships none
+ * for that id, or the packaged file cannot be read.
+ */
+export function readBuiltinBody(id) {
+    const prompt = BUILTIN_PROMPTS.find((candidate) => candidate.id === id);
+    if (prompt === undefined)
+        return undefined;
+    try {
+        const text = readFileSync(fileURLToPath(prompt.file), 'utf8');
+        return text.trim().length === 0 ? undefined : text;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Whether a value is a usable entry id. */
+export function isEntryId(value) {
+    return typeof value === 'string' && value.length <= MAX_ID_LENGTH && ENTRY_ID_PATTERN.test(value);
+}
+/**
+ * Turn a human title into an unused entry id.
+ *
+ * Only ASCII letters and digits survive, so a title written entirely in a
+ * non-Latin script falls back to the `entry` stem. That is deliberate: the id
+ * is an internal handle (file name and section-name suffix), never user copy.
+ *
+ * @param title - the label a person typed.
+ * @param taken - ids already in use.
+ * @returns a lowercase, hyphenated, unused id.
+ */
+export function entryIdFor(title, taken) {
+    const stem = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 32);
+    const base = stem.length >= 2 ? stem : 'entry';
+    const used = new Set(taken);
+    if (!used.has(base))
+        return base;
+    for (let suffix = 2; suffix < 1000; suffix += 1) {
+        const candidate = `${base.slice(0, 28)}-${String(suffix)}`;
+        if (!used.has(candidate))
+            return candidate;
+    }
+    return `${base.slice(0, 24)}-${String(Date.now())}`;
+}
+/**
+ * Keep one id when it is free, or take the nearest free variant of it.
+ *
+ * For the places where the id *is* the identity rather than a handle derived
+ * from a title: a subscribed entry's body is looked up by id upstream, so an
+ * imported `env` that collides is far better off as `env-2` than as whatever a
+ * title — possibly written entirely in a non-Latin script — would slug to.
+ *
+ * @param preferred - the id that was asked for.
+ * @param taken - ids already in use.
+ * @returns `preferred`, or a `-2`-suffixed variant of its stem.
+ */
+export function freeId(preferred, taken) {
+    const used = new Set(taken);
+    if (isEntryId(preferred) && !used.has(preferred))
+        return preferred;
+    const stem = (isEntryId(preferred) ? preferred : 'entry').replace(/-\d+$/, '').slice(0, 28);
+    const base = stem.length >= 2 ? stem : 'entry';
+    if (!used.has(base))
+        return base;
+    for (let suffix = 2; suffix < 1000; suffix += 1) {
+        const candidate = `${base.slice(0, 28)}-${String(suffix)}`;
+        if (!used.has(candidate))
+            return candidate;
+    }
+    return `${base.slice(0, 24)}-${String(Date.now())}`;
+}
+/** One usable entry, or `undefined` when the raw value is unusable. */
+function toEntry(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const { id, title, order, enabled, source } = record;
+    if (!isEntryId(id))
+        return undefined;
+    if (typeof order !== 'number' || !Number.isFinite(order))
+        return undefined;
+    if (typeof enabled !== 'boolean')
+        return undefined;
+    const label = typeof title === 'string' ? title.trim() : '';
+    const entry = {
+        id,
+        title: label.length === 0 ? id : label.slice(0, MAX_TITLE_LENGTH),
+        order,
+        enabled,
+    };
+    if (typeof source === 'string' && source.length > 0)
+        entry.source = source.slice(0, 64);
+    return entry;
+}
+/**
+ * Narrow one resolved settings value into an index. A hand-edited document can
+ * hold anything, so unusable entries are dropped rather than thrown: the worst
+ * case is a prompt with fewer sections, never a session that cannot assemble.
+ *
+ * @param raw - the resolved `prompt-manager` namespace value.
+ * @returns the usable entries, deduplicated by id and capped at {@link MAX_ENTRIES}.
+ */
+export function parseEntries(raw) {
+    const list = typeof raw === 'object' && raw !== null && !Array.isArray(raw)
+        ? raw['entries']
+        : undefined;
+    if (!Array.isArray(list))
+        return [];
+    const entries = [];
+    const seen = new Set();
+    for (const candidate of list) {
+        const entry = toEntry(candidate);
+        if (entry === undefined || seen.has(entry.id))
+            continue;
+        seen.add(entry.id);
+        entries.push(entry);
+        if (entries.length >= MAX_ENTRIES)
+            break;
+    }
+    return entries;
+}
+/** One usable preset, or `undefined` when the raw value is unusable. */
+function toPreset(raw) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return undefined;
+    const record = raw;
+    const { id, name, entries } = record;
+    if (!isEntryId(id))
+        return undefined;
+    const label = typeof name === 'string' ? name.trim() : '';
+    const chosen = [];
+    const seen = new Set();
+    if (Array.isArray(entries)) {
+        for (const candidate of entries) {
+            // An id the index does not carry right now is kept: it may belong to a
+            // subscription that has not come back yet, and dropping it here would
+            // silently rewrite what the person selected.
+            if (typeof candidate !== 'string' || !isEntryId(candidate) || seen.has(candidate))
+                continue;
+            seen.add(candidate);
+            chosen.push(candidate);
+            if (chosen.length >= MAX_PRESET_ENTRIES)
+                break;
+        }
+    }
+    return { id, name: label.length === 0 ? id : label.slice(0, MAX_TITLE_LENGTH), entries: chosen };
+}
+/**
+ * Narrow a resolved settings value into the preset list. Like {@link parseEntries},
+ * a hand-edited document can hold anything, so unusable presets are dropped
+ * rather than thrown: the worst case is a smaller list, never an assembly that
+ * cannot be built.
+ *
+ * @param raw - the resolved `presets` field.
+ * @returns the usable presets, deduplicated by id and capped at {@link MAX_PRESETS}.
+ */
+export function parsePresets(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const presets = [];
+    const seen = new Set();
+    for (const candidate of raw) {
+        const preset = toPreset(candidate);
+        if (preset === undefined || seen.has(preset.id))
+            continue;
+        seen.add(preset.id);
+        presets.push(preset);
+        if (presets.length >= MAX_PRESETS)
+            break;
+    }
+    return presets;
+}
+/**
+ * The id of the preset in force.
+ * @param raw - the resolved `activePreset` field.
+ * @returns the configured id, or `''` when the deployment runs without a preset.
+ */
+export function activePresetOf(raw) {
+    return typeof raw === 'string' ? raw.trim() : '';
+}
+/**
+ * Build the `prompt-manager` namespace schema.
+ *
+ * @param factory - the schemastery factory loaded at mount.
+ * @returns a schema carrying the entry index, the subscriptions, and the
+ * outbound settings the engine reads.
+ */
+export function buildIndexSchema(factory) {
+    const entry = factory.object({
+        id: factory.string().required(),
+        title: factory.string().default(''),
+        order: factory.number().default(USER_ORDER_START),
+        enabled: factory.boolean().default(true),
+        // No default: a local entry must resolve without the field at all. With
+        // `.default('')` every entry carried `source: ''`, which reads as
+        // "subscribed" to anything testing presence rather than value, and a
+        // settings write-back would then persist the phantom field to disk.
+        source: factory.string(),
+    });
+    const source = factory.object({
+        id: factory.string().required(),
+        repo: factory.string().required(),
+        ref: factory.string().default(DEFAULT_SOURCE_REF),
+        mirror: factory.string().default(''),
+        enabled: factory.boolean().default(true),
+    });
+    const preset = factory.object({
+        id: factory.string().required(),
+        name: factory.string().default(''),
+        entries: factory.array(factory.string()).default([]),
+    });
+    const proxy = factory.object({
+        kind: factory.string().default('none'),
+        url: factory.string().default(''),
+    }).default({ kind: 'none', url: '' });
+    return factory.object({
+        entries: factory.array(entry).default([]),
+        presets: factory.array(preset).default([]),
+        // No default beyond the empty string: an unset preset means the entries'
+        // own switches decide, which is what a deployment that never made one gets.
+        activePreset: factory.string().default(''),
+        sources: factory.array(source).default([]),
+        mirror: factory.string().default(''),
+        proxy,
+    });
+}
+//# sourceMappingURL=entries.js.map

package/lib/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../src/entries.ts"],"names":[],"mappings":"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"}

package/lib/guard.js

@@ -0,0 +1,134 @@
+/**
+ * The reference guard: keeps a prompt body from breaking the whole assembly.
+ *
+ * The registry interpolates section text strictly — a reference it cannot
+ * resolve, and a reference whose shape is not a variable name, both throw, and
+ * one throwing section fails the entire assembly. Since the plugin serves text
+ * that a person can also hand-edit in `sections/`, one stray `{{ }}` in a
+ * markdown file would otherwise break every model step of the profile.
+ *
+ * This module therefore mirrors the registry's own scan, reference for
+ * reference, and defuses exactly the groups the registry would throw on: it
+ * puts a zero-width space after each of the two opening braces, so the text
+ * reads the same to a model but no longer starts a reference. Everything the
+ * registry can resolve is left untouched, so a variable another row registers
+ * still interpolates normally.
+ *
+ * The scan below is a deliberate mirror of the registry's `interpolate`
+ * (`@deepseek-ai/dsh-system-prompt`, `lib/index.js`, its `GROUP_AT` and
+ * `VARIABLE_NAME` constants). When that implementation changes shape, this one
+ * has to follow.
+ *
+ * @module @lolkda/dsh-prompt-manager/guard
+ */
+/** A complete `{{...}}` group at the scan position, as the registry reads it. */
+const GROUP_AT = /^\{\{([^{}]*)\}\}/;
+/** Variable-name grammar the registry enforces between the braces. */
+const VARIABLE_NAME = /^[a-z][a-z0-9_]*$/;
+/** Longest snippet of an unusable reference carried into a report. */
+const SNIPPET_LENGTH = 16;
+/**
+ * Zero-width space, inserted after each brace of a reference that must not
+ * resolve. It is invisible in rendered prose, and because every emitted `{` is
+ * followed by one, neither the escaped reference nor its neighbours can ever
+ * re-form a `{{` pair.
+ */
+export const ESCAPE_MARK = '\u200b';
+/** One defused reference, as it appears in the guarded text. */
+function escapedOpener() {
+    return `{${ESCAPE_MARK}{${ESCAPE_MARK}`;
+}
+/** Whether one reference name resolves for the assembly being rendered. */
+function resolvable(name, variables) {
+    return VARIABLE_NAME.test(name) && Object.hasOwn(variables, name) && variables[name] !== undefined;
+}
+/**
+ * Defuse every reference the registry would throw on.
+ *
+ * A reference is defused when its shape is not a variable name, when no
+ * variable of that name exists for this assembly, or when the variable exists
+ * but has no value. A lone `{{` with no later `}}` is literal prose to the
+ * registry and is left exactly as it is.
+ *
+ * @param text - the section text about to be handed to the registry.
+ * @param variables - the names the registry will resolve for this assembly.
+ * @returns the safe text and the references that were defused.
+ */
+export function sanitizeReferences(text, variables) {
+    const escaped = [];
+    let result = '';
+    let last = 0;
+    let open = text.indexOf('{{');
+    while (open >= 0) {
+        const group = GROUP_AT.exec(text.slice(open));
+        if (group === null) {
+            // No complete group here. The registry only fails a stray opener when a
+            // closer follows it somewhere; otherwise the opener is ordinary prose.
+            if (text.indexOf('}}', open + 2) >= 0) {
+                result += text.slice(last, open) + escapedOpener();
+                escaped.push(text.slice(open, open + SNIPPET_LENGTH));
+            }
+            else {
+                result += text.slice(last, open + 2);
+            }
+            last = open + 2;
+            open = text.indexOf('{{', last);
+            continue;
+        }
+        const name = group[0].slice(2, -2);
+        if (resolvable(name, variables)) {
+            result += text.slice(last, open + group[0].length);
+            last = open + group[0].length;
+        }
+        else {
+            // Defuse the opener and keep the body of the reference verbatim: the
+            // prose a person wrote must survive, closing braces included.
+            result += text.slice(last, open) + escapedOpener();
+            escaped.push(group[0]);
+            last = open + 2;
+        }
+        open = text.indexOf('{{', last);
+    }
+    return { text: result + text.slice(last), escaped };
+}
+/**
+ * The references that can never resolve, whatever else is registered.
+ *
+ * A malformed group throws for every deployment, so a save can refuse it up
+ * front. A well-formed name is not listed: another row may register it, and a
+ * name that is merely unregistered today is a body the person may still be
+ * writing.
+ *
+ * @param text - the body about to be stored.
+ * @returns the unusable references, deduplicated, in the order they appear.
+ */
+export function malformedReferences(text) {
+    const found = [];
+    const seen = new Set();
+    let last = 0;
+    let open = text.indexOf('{{');
+    while (open >= 0) {
+        const group = GROUP_AT.exec(text.slice(open));
+        if (group === null) {
+            if (text.indexOf('}}', open + 2) >= 0) {
+                const snippet = text.slice(open, open + SNIPPET_LENGTH);
+                if (!seen.has(snippet)) {
+                    seen.add(snippet);
+                    found.push(snippet);
+                }
+            }
+            last = open + 2;
+            open = text.indexOf('{{', last);
+            continue;
+        }
+        const name = group[0].slice(2, -2);
+        if (!VARIABLE_NAME.test(name) && !seen.has(group[0])) {
+            seen.add(group[0]);
+            found.push(group[0]);
+        }
+        last = open + group[0].length;
+        open = text.indexOf('{{', last);
+    }
+    return found;
+}
+//# sourceMappingURL=guard.js.map

package/lib/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":"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"}