@felan-ai/ext-output-style 0.2.1 → 0.3.0

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2026 Felan contributors
+Copyright (c) 2026 Julius Brussee
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/NOTICE

@@ -4,3 +4,10 @@ Copyright (c) 2026 Felan contributors
 
 This package is original Felan code licensed under the MIT License included in
 this package. It has no third-party runtime dependencies.
+
+The built-in concise instructions adapt wording from Julius Brussee's Caveman
+skill:
+https://github.com/JuliusBrussee/caveman/blob/main/skills/caveman/SKILL.md
+
+Copyright (c) 2026 Julius Brussee. Used under the MIT License preserved in
+LICENSE.

package/README.md

@@ -3,24 +3,42 @@
 Portable output-style instructions for Felan sessions.
 
 The extension appends one clearly bounded `## Output Style` section to the
-system prompt before each model run. It accepts only the built-in `concise`,
-`explanatory`, and `caveman` styles; arbitrary prompt text and file-backed
-styles are not supported. `concise` is the default.
+system prompt before each model run. It provides the built-in `concise`,
+and `explanatory` styles plus a `custom` style for caller-provided instructions.
+`concise` is the default. It minimizes prose while preserving clarity, exact
+technical content, conditions, caveats, verification, and blockers, and it
+expands for ambiguity, safety-sensitive actions, errors, and complex plans.
+File-backed styles are not supported.
 
 ```ts
 import { createOutputStyleExtension } from '@felan-ai/ext-output-style';
 
 const extension = createOutputStyleExtension('explanatory');
-const caveman = createOutputStyleExtension('caveman');
+const concise = createOutputStyleExtension('concise');
+const experiment = createOutputStyleExtension('custom', 'Answer in one compact paragraph.');
 ```
 
-Felan declares the style as `extensionConfig.outputStyle.style`. The local TUI,
-CLI, `/settings`, and Agent Core consumers all resolve this setting before
-activating the extension for root and child sessions.
+Felan declares the style as `extensionConfig.outputStyle.style`. Custom
+instructions use `extensionConfig.outputStyle.instructions`:
+
+```json
+{
+  "extensionConfig": {
+    "outputStyle": {
+      "style": "custom",
+      "instructions": "Answer in one compact paragraph without omitting blockers."
+    }
+  }
+}
+```
+
+The local TUI, CLI, `/settings`, and Agent Core consumers resolve these fields
+before activating the extension for root and child sessions. A custom style
+requires non-empty instructions.
 
 ## Package boundary and requirements
 
-The package owns the supported style names, their fixed instructions,
+The package owns the supported style names, built-in instructions, custom-text
 validation, and prompt-section formatting. A host owns style selection,
 built-in enablement, and session lifecycle. The package requires a compatible
 `@felan-ai/agent-core` peer and does not read settings, prompt files, or ambient
@@ -46,5 +64,7 @@ pnpm --filter @felan-ai/ext-output-style test
 
 ## Attribution
 
-This package is original Felan project code. See [NOTICE](NOTICE) and
-[LICENSE](LICENSE).
+The extension implementation is original Felan project code. The merged
+concise instructions adapt wording from Julius Brussee's MIT-licensed
+[Caveman skill](https://github.com/JuliusBrussee/caveman/blob/main/skills/caveman/SKILL.md).
+See [NOTICE](NOTICE) and [LICENSE](LICENSE).

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 import { type FelanExtension } from '@felan-ai/agent-core';
-export declare const OUTPUT_STYLES: readonly ["concise", "explanatory", "caveman"];
+export declare const OUTPUT_STYLES: readonly ["concise", "explanatory", "custom"];
 export type OutputStyle = typeof OUTPUT_STYLES[number];
 export declare const DEFAULT_OUTPUT_STYLE: OutputStyle;
 export declare const OUTPUT_STYLE_CONFIG: import("@felan-ai/agent-core").ExtensionConfigDefinition<{
-    readonly style: import("@felan-ai/agent-core").ExtensionConfigField<"concise" | "explanatory" | "caveman">;
+    readonly style: import("@felan-ai/agent-core").ExtensionConfigField<"concise" | "explanatory" | "custom">;
+    readonly instructions: import("@felan-ai/agent-core").ExtensionConfigField<string>;
 }>;
 export declare function parseOutputStyle(value?: unknown): OutputStyle;
-export declare function formatOutputStyleSection(style: OutputStyle): string;
-export declare function createOutputStyleExtension(value?: unknown): FelanExtension;
+export declare function formatOutputStyleSection(style: OutputStyle, instructions?: unknown): string;
+export declare function createOutputStyleExtension(value?: unknown, instructions?: unknown): FelanExtension;
 declare const outputStyleExtension: FelanExtension;
 export default outputStyleExtension;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,KAAK,cAAc,EAA0B,MAAM,sBAAsB,CAAC;AAEjJ,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,oBAAoB,EAAE,WAAuB,CAAC;AAC3D,eAAO,MAAM,mBAAmB;;EAU9B,CAAC;AAyBH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAA8B,GAAG,WAAW,CAKnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQnE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,OAA8B,GAAG,cAAc,CAShG;AAED,QAAA,MAAM,oBAAoB,EAAE,cAEtB,CAAC;AAGP,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgE,KAAK,cAAc,EAA0B,MAAM,sBAAsB,CAAC;AAEjJ,eAAO,MAAM,aAAa,+CAAgD,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,oBAAoB,EAAE,WAAuB,CAAC;AAC3D,eAAO,MAAM,mBAAmB;;;EAe9B,CAAC;AA0BH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAA8B,GAAG,WAAW,CAKnF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,CAW3F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,GAAE,OAA8B,EACrC,YAAY,CAAC,EAAE,OAAO,GACrB,cAAc,CAShB;AAED,QAAA,MAAM,oBAAoB,EAAE,cAGtB,CAAC;AAGP,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 import { associateExtensionConfig, configField, defineExtensionConfig } from '@felan-ai/agent-core';
-export const OUTPUT_STYLES = ['concise', 'explanatory', 'caveman'];
+export const OUTPUT_STYLES = ['concise', 'explanatory', 'custom'];
 export const DEFAULT_OUTPUT_STYLE = 'concise';
 export const OUTPUT_STYLE_CONFIG = defineExtensionConfig({
     id: 'outputStyle',
@@ -10,28 +10,34 @@ export const OUTPUT_STYLE_CONFIG = defineExtensionConfig({
             description: 'Response detail and explanation style',
             cliName: 'output-style',
         }),
+        instructions: configField.string({
+            default: '',
+            description: 'Custom system-prompt instructions used when output style is custom',
+            cliName: 'output-style-instructions',
+        }),
     },
 });
 const OUTPUT_STYLE_START = '<output_style>';
 const OUTPUT_STYLE_END = '</output_style>';
 const STYLE_INSTRUCTIONS = {
     concise: [
-        'Keep responses concise and direct. Lead with the outcome or next action.',
-        'Use headings and bullets only when they make the response easier to scan.',
-        'Do not omit necessary caveats, verification results, or blockers for brevity.',
+        'Use the fewest words that preserve correctness, clarity, and all required technical substance. Lead with the outcome or next action.',
+        'Omit greetings, restatements, filler, decorative prose, emoji, redundant transitions, duplicate recaps, and filler closings.',
+        'Prefer short sentences, compact bullets, and concise paragraphs. Fragments and standard, widely understood abbreviations are acceptable only when they remain clear and professional; do not invent abbreviations or mangle grammar merely to shorten.',
+        'Use headings only when they improve scanability. State each fact once; do not provide both a normal answer and a terse duplicate.',
+        'Keep technical terms, code, commands, paths, identifiers, API names, numbers, units, and exact error messages unchanged.',
+        'Never omit or alter negation, conditions, scope, exceptions, caveats, verification results, or blockers merely to shorten the response.',
+        'Quote the shortest decisive exact error lines and summarize the rest accurately unless the full log is requested.',
+        'Expand into clear, complete prose whenever compression could cause ambiguity, especially for security warnings, destructive or irreversible actions, ordered procedures, errors, blockers, limitations, recovery instructions, complex plans, tradeoffs, or clarification requests.',
+        'Do not narrate ordinary tool calls or announce the next tool call. Before a tool call, write only what is needed to resolve ambiguity, explain a safety concern, or confirm an irreversible action.',
+        "Reply in the user's language. Do not translate code, commands, identifiers, API names, or exact error strings unless requested.",
+        'For documentation, comments, commits, issues, pull requests, tickets, and other durable artifacts, use clear conventional prose and preserve requested formats.',
     ],
     explanatory: [
         'Explain the reasoning and important tradeoffs behind recommendations and changes.',
         'Provide enough context for the user to understand how the result works and how to verify it.',
         'Keep explanations relevant to the request and avoid repeating the same point.',
     ],
-    caveman: [
-        'Use the fewest words that preserve correctness. Prefer short fragments, compact bullets, and standard abbreviations.',
-        'Omit greetings, restatements, transitions, and filler.',
-        'Expand enough to be clear for errors, security warnings, destructive actions, blockers, and complex plans.',
-        'Keep code, commands, paths, identifiers, numbers, and error messages exact.',
-        'Never omit required caveats, verification results, or blockers for brevity.',
-    ],
 };
 export function parseOutputStyle(value = DEFAULT_OUTPUT_STYLE) {
     if (typeof value === 'string' && OUTPUT_STYLES.includes(value)) {
@@ -39,25 +45,34 @@ export function parseOutputStyle(value = DEFAULT_OUTPUT_STYLE) {
     }
     throw new Error(`outputStyle must be one of: ${OUTPUT_STYLES.join(', ')}`);
 }
-export function formatOutputStyleSection(style) {
+export function formatOutputStyleSection(style, instructions) {
+    const body = style === 'custom'
+        ? parseCustomInstructions(instructions)
+        : STYLE_INSTRUCTIONS[style].map((instruction) => `- ${instruction}`).join('\n');
     return [
         '## Output Style',
         '',
         OUTPUT_STYLE_START,
-        ...STYLE_INSTRUCTIONS[style].map((instruction) => `- ${instruction}`),
+        body,
         OUTPUT_STYLE_END,
     ].join('\n');
 }
-export function createOutputStyleExtension(value = DEFAULT_OUTPUT_STYLE) {
+export function createOutputStyleExtension(value = DEFAULT_OUTPUT_STYLE, instructions) {
     const style = parseOutputStyle(value);
-    const section = formatOutputStyleSection(style);
+    const section = formatOutputStyleSection(style, instructions);
     return (pi) => {
         pi.on('before_agent_start', (event) => {
             return { systemPrompt: `${event.systemPrompt}\n\n${section}` };
         });
     };
 }
-const outputStyleExtension = ((pi) => createOutputStyleExtension(pi.config?.style ?? DEFAULT_OUTPUT_STYLE)(pi));
+const outputStyleExtension = ((pi) => createOutputStyleExtension(pi.config?.style ?? DEFAULT_OUTPUT_STYLE, pi.config?.instructions)(pi));
 associateExtensionConfig(outputStyleExtension, OUTPUT_STYLE_CONFIG);
 export default outputStyleExtension;
+function parseCustomInstructions(value) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error('outputStyle.instructions must be a non-empty string when outputStyle is custom');
+    }
+    return value.trim();
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,qBAAqB,EAA+C,MAAM,sBAAsB,CAAC;AAEjJ,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAU,CAAC;AAG5E,MAAM,CAAC,MAAM,oBAAoB,GAAgB,SAAS,CAAC;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;IACvD,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE;QACN,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE;YACrC,OAAO,EAAE,oBAAoB;YAC7B,WAAW,EAAE,uCAAuC;YACpD,OAAO,EAAE,cAAc;SACxB,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAE3C,MAAM,kBAAkB,GAAqD;IAC3E,OAAO,EAAE;QACP,0EAA0E;QAC1E,2EAA2E;QAC3E,+EAA+E;KAChF;IACD,WAAW,EAAE;QACX,mFAAmF;QACnF,8FAA8F;QAC9F,+EAA+E;KAChF;IACD,OAAO,EAAE;QACP,sHAAsH;QACtH,wDAAwD;QACxD,4GAA4G;QAC5G,6EAA6E;QAC7E,6EAA6E;KAC9E;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,QAAiB,oBAAoB;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAoB,CAAC,EAAE,CAAC;QAC9E,OAAO,KAAoB,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAkB;IACzD,OAAO;QACL,iBAAiB;QACjB,EAAE;QACF,kBAAkB;QAClB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC;QACrE,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAiB,oBAAoB;IAC9E,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAEhD,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE;YACpC,OAAO,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,OAAO,OAAO,EAAE,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAmB,CAAC,CAAC,EAAqB,EAAE,EAAE,CAAC,0BAA0B,CACjG,EAAE,CAAC,MAAM,EAAE,KAAK,IAAI,oBAAoB,CACzC,CAAC,EAAE,CAAC,CAAC,CAAC;AACP,wBAAwB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAC;AAEpE,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@felan-ai/ext-output-style",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Portable output-style system prompt extension for Felan",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "@felan-ai/agent-core": "^0.5.0"
   },
   "devDependencies": {
-    "@felan-ai/agent-core": "0.5.2"
+    "@felan-ai/agent-core": "0.5.3"
   },
   "publishConfig": {
     "access": "public",