@mengyuly/dsh-ponytail 0.1.5 → 0.2.0

package/lib/types/index.d.ts

@@ -15,6 +15,19 @@
 import type { Context } from '@deepseek-ai/cordis';
 export declare const name = "ponytail";
 export declare const inject: string[];
+/**
+ * Cordis profile-level configuration (set per profile via the bundle row's
+ * `config` in a profile patch). `defaultMode` sits between the environment
+ * variable and the user config file in the default-resolution chain.
+ *
+ * No `Config` schema is exported on purpose: cordis passes the raw config
+ * through unvalidated then, so an invalid `defaultMode` falls back with a
+ * one-time warning instead of failing the plugin mount.
+ */
+export interface PonytailConfig {
+    /** Profile-scoped default intensity, e.g. `web → full`, `tui → lite`. */
+    defaultMode?: unknown;
+}
 /** Extract the plain text of one user message (only its text blocks). */
 export declare function messageText(message: {
     content: readonly {
@@ -33,4 +46,4 @@ export declare function containsDeactivation(messages: readonly {
  * Register the always-on ruleset section, the runtime skills, the slash
  * commands, and the plain-text deactivation listener.
  */
-export declare function apply(ctx: Context): void;
+export declare function apply(ctx: Context, config?: PonytailConfig): void;

package/lib/types/instructions.d.ts

@@ -1,23 +1,17 @@
 /**
- * Build the mode-filtered ponytail ruleset. Ported from the upstream
- * `hooks/ponytail-instructions.js`, so the injected text is byte-for-byte the
- * same ruleset every other host emits, filtered to the active intensity.
+ * Structured ponytail ruleset composition. Each intensity is built from
+ * explicit fragments — common rules, a never-cut safety boundary list, and
+ * the mode's own rules — instead of filtering one Markdown body with regexes.
+ * The three intensities therefore differ in their actual instructions, not
+ * just in a table row.
  *
  * @module @deepseek-ai/dsh-ponytail
  */
 import { type PonytailRuntimeMode } from './modes.ts';
 /**
- * Keep a line of the skill body only when it belongs to every mode or to the
- * active one. Both shape-sensitive spots (the intensity table rows and the
- * quoted worked examples) are keyed by a mode name; ordinary rules survive
- * verbatim, even ones whose prose starts with a mode-looking word.
- */
-export declare function filterSkillBodyForMode(body: string, mode: PonytailRuntimeMode | null | undefined): string;
-/** Minimal instruction set if the skill body can't be read (parity fallback). */
-export declare function fallbackInstructions(mode: PonytailRuntimeMode): string;
-/**
- * The full injected ruleset for one intensity: the "PONYTAIL MODE ACTIVE"
- * header plus the body filtered down to that mode's rows and examples.
- * Returns an empty string for `off` (ponytail contributes nothing).
+ * The injected ruleset for one intensity, composed from the structured
+ * fragments above. Returns an empty string for `off` (ponytail contributes
+ * nothing). Renders are pure per mode and cached so every turn's bytes stay
+ * identical.
  */
 export declare function getPonytailInstructions(mode: PonytailRuntimeMode | null | undefined): string;

package/lib/types/modes.d.ts

@@ -47,17 +47,26 @@ export interface DefaultModeResolution {
     readonly issue?: DefaultModeIssue;
 }
 /**
- * Read the configured default with diagnostics: environment variable first,
- * then the config file, then `full`. A missing config file is normal and
- * yields no issue; a broken one yields the fallback mode plus one issue for
- * the caller to warn about once.
+ * Read the configured default with diagnostics. Priority:
+ * `PONYTAIL_DEFAULT_MODE` → Cordis profile `defaultMode` → user config file →
+ * `full`. A missing config file is normal and yields no issue; a broken one
+ * yields the fallback mode plus one issue for the caller to warn about once.
+ * @param env - the process environment to read.
+ * @param profileMode - the validated Cordis profile `defaultMode`, or `null`
+ *   when the profile config is absent or invalid (invalid values are reported
+ *   by the caller; this function only consumes valid ones).
  */
-export declare function readDefaultModeInfo(env?: NodeJS.ProcessEnv): DefaultModeResolution;
+export declare function readDefaultModeInfo(env?: NodeJS.ProcessEnv, profileMode?: PonytailRuntimeMode | null): DefaultModeResolution;
 /**
  * Read the configured default for this host: environment variable first, then
- * the config file, then `full`.
+ * the Cordis profile `defaultMode`, then the user config file, then `full`.
  */
-export declare function readDefaultMode(env?: NodeJS.ProcessEnv): PonytailRuntimeMode;
+export declare function readDefaultMode(env?: NodeJS.ProcessEnv, profileMode?: PonytailRuntimeMode | null): PonytailRuntimeMode;
+/**
+ * Why a `saved` default is not the effective one — for the `/ponytail default`
+ * result message. `null` means the saved value is effective.
+ */
+export declare function defaultOverrideReason(env: NodeJS.ProcessEnv, profileMode: PonytailRuntimeMode | null): 'PONYTAIL_DEFAULT_MODE' | 'profile configuration' | null;
 /**
  * Persist a new default level to the config file, preserving other fields.
  * Returns the normalized mode, or `null` when the value is not a runtime mode.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mengyuly/dsh-ponytail",
   "description": "Lazy senior dev mode for DeepSeek Harness: always-on minimal-code ruleset, intensity switching, and short review/audit/debt/gain/help skills",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -44,7 +44,8 @@
     "@deepseek-ai/dsh-invariants": ">=0.0.1-rc <2",
     "@deepseek-ai/dsh-llm": ">=0.0.1-rc <2",
     "@deepseek-ai/dsh-skill": ">=0.0.1-rc <2",
-    "@deepseek-ai/dsh-system-prompt": ">=0.0.1-rc <2"
+    "@deepseek-ai/dsh-system-prompt": ">=0.0.1-rc <2",
+    "@deepseek-ai/schemastery": "^3.18.0"
   },
   "scripts": {
     "sync:dist": "node scripts/sync-dist.mjs",