@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/schemas/workflow-v2-contracts.js

@@ -0,0 +1,236 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Step contracts of the compiled workflow definition (schema_version "2.0").
+ * Tool bindings, predicates, human interaction, semantic judgment, retry, and browser procedures.
+ */
+import { z } from 'zod';
+import { WorkflowErrorCode, WorkflowHumanTransport, WorkflowTemplateValue, WorkflowVerdict, } from './workflow-v2-vocabulary.js';
+export const WorkflowToolBinding = z.object({
+    server_tool_name: z.string().min(1).max(200).optional(),
+    host_tool_name: z.string().min(1).max(200),
+    /** Absent means the profile the run compiles for, which keeps one definition portable. */
+    host_profile: z.string().min(1).max(200).optional(),
+    input_schema_digest: z.string().min(1).max(200).optional(),
+    output_schema_digest: z.string().min(1).max(200).optional(),
+    protocol_version: z.string().min(1).max(100).optional(),
+});
+export const WorkflowPredicate = z.object({
+    id: z.string().min(1).max(100),
+    kind: z.enum([
+        'schema-valid',
+        'equals',
+        'in-set',
+        'number-compare',
+        'text-normalized-equals',
+        'text-contains',
+        'text-regex',
+        'json-path-equals',
+        'file-check',
+        'origin-check',
+        'digest-check',
+        'artifact-count',
+        'playwright-assertion',
+    ]),
+    parameters: z.record(z.string(), WorkflowTemplateValue).default({}),
+});
+const WorkflowHumanInteraction = z.enum(['question', 'manual_action', 'approval', 'observation']);
+export const WorkflowHumanStep = z.object({
+    interaction: WorkflowHumanInteraction,
+    transport: WorkflowHumanTransport.optional(),
+    instruction: z.string().min(1).max(4000),
+    expected_observation: z.string().max(2000).optional(),
+    options: z.array(z.string().min(1).max(200)).min(1).max(20),
+    allow_freeform: z.boolean().default(false),
+    required: z.boolean().default(true),
+    prevalidate: z.array(z.string().min(1).max(100)).default([]),
+    bypass_when: z.enum(['all_pass', 'never']).default('never'),
+    response_mapping: z.record(z.string(), WorkflowVerdict),
+    on_unavailable: z.enum(['pause', 'declared-fallback']).default('pause'),
+    evidence_ids: z.array(z.string().min(1).max(100)).default([]),
+});
+export const WorkflowSemanticJudgment = z.object({
+    rubric: z.array(z.string().min(1).max(500)).min(1).max(20),
+    verdicts: z.array(WorkflowVerdict).min(2),
+    minimum_confidence: z.number().min(0).max(1),
+    rationale_max_length: z.number().int().min(1).max(4000).default(1000),
+    inconclusive_target: z.string().min(1).max(100),
+});
+export const WorkflowRetryPolicy = z.object({
+    max_attempts: z.number().int().min(1).max(100).default(1),
+    on_codes: z.array(WorkflowErrorCode).default([]),
+    backoff_ms: z.number().int().min(0).max(86_400_000).default(0),
+    requires_idempotency: z.boolean().default(false),
+});
+export const WorkflowBrowserProcedure = z
+    .object({
+    mode: z.enum([
+        'playwright-test',
+        'playwright-mcp',
+        'integrated-browser',
+        'run-playwright-code',
+    ]),
+    script_path: z.string().min(1).max(500).optional(),
+    actions: z
+        .array(z.object({
+        tool_name: z.string().min(1).max(200),
+        parameters: z.record(z.string(), WorkflowTemplateValue).default({}),
+    }))
+        .max(100)
+        .default([]),
+    assertions: z.array(z.string().min(1).max(1000)).min(1).max(100),
+    artifacts: z
+        .array(z.enum(['html-report', 'json-report', 'blob-report', 'trace', 'screenshot', 'video']))
+        .default([]),
+    dialog_route: z.enum(['fail', 'repair', 'escalate']).default('escalate'),
+    selector_drift_route: z.enum(['fail', 'repair', 'escalate']).default('repair'),
+})
+    .superRefine((procedure, context) => {
+    if (procedure.mode === 'playwright-test' && !procedure.script_path) {
+        context.addIssue({
+            code: 'custom',
+            path: ['script_path'],
+            message: 'playwright-test requires an authored script path',
+        });
+    }
+    if (procedure.mode !== 'playwright-test' && procedure.actions.length === 0) {
+        context.addIssue({
+            code: 'custom',
+            path: ['actions'],
+            message: `${procedure.mode} requires authored actions`,
+        });
+    }
+    if (procedure.mode === 'run-playwright-code' &&
+        procedure.actions.some((action) => action.tool_name !== 'run_playwright_code')) {
+        context.addIssue({
+            code: 'custom',
+            path: ['actions'],
+            message: 'run-playwright-code procedures may only call run_playwright_code',
+        });
+    }
+    if (procedure.mode === 'run-playwright-code') {
+        const forbidden = /\b(?:eval|Function|require|import\s*\(|process|child_process|fs\.|Deno|Bun|fetch)\b/;
+        for (const [index, action] of procedure.actions.entries()) {
+            const code = action.parameters.code;
+            if (typeof code !== 'string' || code.length === 0 || code.length > 20_000) {
+                context.addIssue({
+                    code: 'custom',
+                    path: ['actions', index, 'parameters', 'code'],
+                    message: 'run_playwright_code requires a non-empty code string of at most 20000 characters',
+                });
+            }
+            else if (forbidden.test(code)) {
+                context.addIssue({
+                    code: 'custom',
+                    path: ['actions', index, 'parameters', 'code'],
+                    message: 'run_playwright_code contains a forbidden runtime capability',
+                });
+            }
+        }
+    }
+});
+/**
+ * A value the operator fills in on a step: what was observed, which build was tested, yes, no or
+ * unsure per checked point (STORY-450). The set of kinds is closed and small on purpose: every
+ * kind is carried by the panel, the validator, four report formats and redaction.
+ */
+export const WorkflowStepField = z
+    .object({
+    id: z
+        .string()
+        .regex(/^[a-z][a-z0-9_-]*$/)
+        .max(60),
+    label: z.string().min(1).max(120),
+    kind: z.enum(['text', 'multiline', 'number', 'boolean', 'choice']),
+    /** Required on a step reported done or answered positively; absent means optional. */
+    required: z.boolean().optional(),
+    help: z.string().max(500).optional(),
+    /** The options of a choice field, and of no other kind. */
+    options: z.array(z.string().min(1).max(200)).min(1).max(20).optional(),
+})
+    .superRefine((field, context) => {
+    if (field.kind === 'choice' && !field.options) {
+        context.addIssue({
+            code: 'custom',
+            path: ['options'],
+            message: 'a choice field needs options',
+        });
+    }
+    if (field.kind !== 'choice' && field.options) {
+        context.addIssue({
+            code: 'custom',
+            path: ['options'],
+            message: 'only a choice field takes options',
+        });
+    }
+});
+/**
+ * Where a group of steps happens: a place and a phase, its platform, and whether it is a remote
+ * machine whose commands are copied rather than run here (STORY-464, DEC-021).
+ */
+export const WorkflowSection = z.object({
+    id: z
+        .string()
+        .regex(/^[a-z][a-z0-9_-]*$/)
+        .max(60),
+    title: z.string().min(1).max(120),
+    place: z.string().max(200).optional(),
+    platform: z.enum(['windows', 'linux', 'macos']).optional(),
+    remote: z.boolean().optional(),
+    note: z.string().max(200).optional(),
+});
+/** Shell contract of a script step; the command itself stays in `arguments_template.command`. */
+/** A pattern that compiles as a multiline regular expression; group 1, else the match, is kept. */
+const ExtractPattern = z
+    .string()
+    .min(1)
+    .max(500)
+    .refine((pattern) => {
+    try {
+        new RegExp(pattern, 'm');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, { message: 'extract pattern is not a valid regular expression' });
+export const WorkflowScriptContract = z.object({
+    shell: z.enum(['bash', 'pwsh', 'cmd']),
+    working_directory: z.string().min(1).max(500).optional(),
+    expect_json: z.boolean().default(false),
+    /**
+     * Named values read from stdout (BUG-216), stored as `outputs.<step>.values.<name>` so a later
+     * step's text inserts one value instead of the whole capture. No default, so a definition
+     * without it keeps its digest.
+     */
+    extract: z
+        .record(z.string().regex(/^[a-z][a-z0-9_]{0,39}$/), ExtractPattern)
+        .refine((entries) => Object.keys(entries).length <= 20, {
+        message: 'a script declares at most 20 extracts',
+    })
+        .optional(),
+});
+/** Argument convention of a host tool; only key names are checked, values stay templates. */
+export const WorkflowArgumentSchema = z.object({
+    properties: z.record(z.string(), z.unknown()).default({}),
+    required: z.array(z.string().min(1).max(100)).default([]),
+    additionalProperties: z.boolean().default(true),
+});
+export const WorkflowHostTool = z.object({
+    /** Exact host tool name, or a prefix ending in `*` such as `mcp:*`. */
+    host_tool_name: z.string().min(1).max(200),
+    kinds: z.array(z.enum(['tool', 'script', 'artifact', 'cleanup'])).min(1),
+    argument_schema: WorkflowArgumentSchema.optional(),
+    notes: z.string().max(1000).optional(),
+});
+export const WorkflowHostProfile = z.object({
+    name: z
+        .string()
+        .regex(/^[a-z][a-z0-9_.-]*$/)
+        .max(100),
+    description: z.string().max(1000).optional(),
+    tools: z.array(WorkflowHostTool).min(1),
+    human_transport: WorkflowHumanTransport,
+});
+//# sourceMappingURL=workflow-v2-contracts.js.map

package/dist/schemas/workflow-v2-contracts.js.map

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

package/dist/schemas/workflow-v2-vocabulary.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed vocabulary of the compiled workflow contract (schema_version "2.0").
+ * Step kinds, side-effect classes, verdicts, error codes, and template values.
+ */
+import { z } from 'zod';
+export declare const WorkflowStepKind: z.ZodEnum<{
+    artifact: "artifact";
+    cleanup: "cleanup";
+    human: "human";
+    predicate: "predicate";
+    script: "script";
+    semantic_judgment: "semantic_judgment";
+    tool: "tool";
+}>;
+export type WorkflowStepKind = z.infer<typeof WorkflowStepKind>;
+export declare const WorkflowSideEffect: z.ZodEnum<{
+    credentialed: "credentialed";
+    irreversible: "irreversible";
+    "local-destructive": "local-destructive";
+    "local-reversible": "local-reversible";
+    "read-only": "read-only";
+    "remote-mutating": "remote-mutating";
+    "remote-reversible": "remote-reversible";
+}>;
+export type WorkflowSideEffect = z.infer<typeof WorkflowSideEffect>;
+export declare const WorkflowVerdict: z.ZodEnum<{
+    BLOCKED: "BLOCKED";
+    CANCELLED: "CANCELLED";
+    FAIL: "FAIL";
+    INCONCLUSIVE: "INCONCLUSIVE";
+    NOT_RECORDED: "NOT_RECORDED";
+    PASS: "PASS";
+}>;
+export type WorkflowVerdict = z.infer<typeof WorkflowVerdict>;
+export declare const WorkflowErrorCode: z.ZodEnum<{
+    ARTIFACT_INVALID: "ARTIFACT_INVALID";
+    ASSERTION_FAILED: "ASSERTION_FAILED";
+    AUTHORING_INVALID: "AUTHORING_INVALID";
+    BINDING_SCHEMA_DRIFT: "BINDING_SCHEMA_DRIFT";
+    BINDING_UNAVAILABLE: "BINDING_UNAVAILABLE";
+    CANCELLED: "CANCELLED";
+    EXECUTION_FAILED: "EXECUTION_FAILED";
+    HUMAN_DECLINED: "HUMAN_DECLINED";
+    INPUT_INVALID: "INPUT_INVALID";
+    INTERNAL_ERROR: "INTERNAL_ERROR";
+    MANIFEST_INTEGRITY: "MANIFEST_INTEGRITY";
+    PARAMETER_MUTATION: "PARAMETER_MUTATION";
+    PERSISTENCE_CONFLICT: "PERSISTENCE_CONFLICT";
+    POLICY_DENIED: "POLICY_DENIED";
+    PROTOCOL_ERROR: "PROTOCOL_ERROR";
+    SEMANTIC_INCONCLUSIVE: "SEMANTIC_INCONCLUSIVE";
+    TEMPLATE_ERROR: "TEMPLATE_ERROR";
+    TIMEOUT: "TIMEOUT";
+    TRANSPORT_ERROR: "TRANSPORT_ERROR";
+    UNCERTAIN_OUTCOME: "UNCERTAIN_OUTCOME";
+}>;
+export type WorkflowErrorCode = z.infer<typeof WorkflowErrorCode>;
+export declare const WorkflowErrorDisposition: z.ZodEnum<{
+    escalate: "escalate";
+    fail: "fail";
+    pause: "pause";
+    reconcile: "reconcile";
+    repair: "repair";
+    retry: "retry";
+}>;
+export type WorkflowErrorDisposition = z.infer<typeof WorkflowErrorDisposition>;
+export declare const WorkflowRouteVerdict: z.ZodEnum<{
+    BLOCKED: "BLOCKED";
+    CANCELLED: "CANCELLED";
+    FAIL: "FAIL";
+    INCONCLUSIVE: "INCONCLUSIVE";
+    PASS: "PASS";
+}>;
+export type WorkflowRouteVerdict = z.infer<typeof WorkflowRouteVerdict>;
+/** Who carries out a step of a v2 run: the person in the guide view, or the agent (DEC-023). */
+export declare const WorkflowParty: z.ZodEnum<{
+    agent: "agent";
+    operator: "operator";
+}>;
+export type WorkflowParty = z.infer<typeof WorkflowParty>;
+/** Human-step transports a host profile can declare; `conversation` works on every host. */
+export declare const WorkflowHumanTransport: z.ZodEnum<{
+    claude_code_ask_user_question: "claude_code_ask_user_question";
+    conversation: "conversation";
+    vscode_askQuestions: "vscode_askQuestions";
+    vscode_walkthrough_panel: "vscode_walkthrough_panel";
+}>;
+export type WorkflowHumanTransport = z.infer<typeof WorkflowHumanTransport>;
+export declare const WorkflowTemplateValue: z.ZodType;
+//# sourceMappingURL=workflow-v2-vocabulary.d.ts.map

package/dist/schemas/workflow-v2-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-vocabulary.d.ts","sourceRoot":"","sources":["../../src/schemas/workflow-v2-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;EAQ3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,kBAAkB;;;;;;;;EAQ7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe;;;;;;;EAO1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAqB5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,gGAAgG;AAChG,eAAO,MAAM,aAAa;;;EAAgC,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;EAKjC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAOpC,CAAC"}

package/dist/schemas/workflow-v2-vocabulary.js

@@ -0,0 +1,89 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed vocabulary of the compiled workflow contract (schema_version "2.0").
+ * Step kinds, side-effect classes, verdicts, error codes, and template values.
+ */
+import { z } from 'zod';
+export const WorkflowStepKind = z.enum([
+    'tool',
+    'script',
+    'predicate',
+    'human',
+    'semantic_judgment',
+    'artifact',
+    'cleanup',
+]);
+export const WorkflowSideEffect = z.enum([
+    'read-only',
+    'local-reversible',
+    'local-destructive',
+    'remote-reversible',
+    'remote-mutating',
+    'credentialed',
+    'irreversible',
+]);
+export const WorkflowVerdict = z.enum([
+    'PASS',
+    'FAIL',
+    'BLOCKED',
+    'CANCELLED',
+    'INCONCLUSIVE',
+    'NOT_RECORDED',
+]);
+export const WorkflowErrorCode = z.enum([
+    'AUTHORING_INVALID',
+    'MANIFEST_INTEGRITY',
+    'BINDING_UNAVAILABLE',
+    'BINDING_SCHEMA_DRIFT',
+    'INPUT_INVALID',
+    'TEMPLATE_ERROR',
+    'PARAMETER_MUTATION',
+    'POLICY_DENIED',
+    'PROTOCOL_ERROR',
+    'TRANSPORT_ERROR',
+    'TIMEOUT',
+    'CANCELLED',
+    'EXECUTION_FAILED',
+    'ASSERTION_FAILED',
+    'SEMANTIC_INCONCLUSIVE',
+    'HUMAN_DECLINED',
+    'ARTIFACT_INVALID',
+    'PERSISTENCE_CONFLICT',
+    'UNCERTAIN_OUTCOME',
+    'INTERNAL_ERROR',
+]);
+export const WorkflowErrorDisposition = z.enum([
+    'retry',
+    'reconcile',
+    'repair',
+    'pause',
+    'escalate',
+    'fail',
+]);
+export const WorkflowRouteVerdict = z.enum([
+    'PASS',
+    'FAIL',
+    'BLOCKED',
+    'CANCELLED',
+    'INCONCLUSIVE',
+]);
+/** Who carries out a step of a v2 run: the person in the guide view, or the agent (DEC-023). */
+export const WorkflowParty = z.enum(['operator', 'agent']);
+/** Human-step transports a host profile can declare; `conversation` works on every host. */
+export const WorkflowHumanTransport = z.enum([
+    'vscode_askQuestions',
+    'vscode_walkthrough_panel',
+    'claude_code_ask_user_question',
+    'conversation',
+]);
+export const WorkflowTemplateValue = z.union([
+    z.string().max(4000),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(z.unknown()),
+    z.record(z.string(), z.unknown()),
+]);
+//# sourceMappingURL=workflow-v2-vocabulary.js.map

package/dist/schemas/workflow-v2-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-vocabulary.js","sourceRoot":"","sources":["../../src/schemas/workflow-v2-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,MAAM;IACN,QAAQ;IACR,WAAW;IACX,OAAO;IACP,mBAAmB;IACnB,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,WAAW;IACX,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,MAAM;IACN,MAAM;IACN,SAAS;IACT,WAAW;IACX,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,mBAAmB;IACnB,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;IACtB,eAAe;IACf,gBAAgB;IAChB,oBAAoB;IACpB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,SAAS;IACT,WAAW;IACX,kBAAkB;IAClB,kBAAkB;IAClB,uBAAuB;IACvB,gBAAgB;IAChB,kBAAkB;IAClB,sBAAsB;IACtB,mBAAmB;IACnB,gBAAgB;CACjB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7C,OAAO;IACP,WAAW;IACX,QAAQ;IACR,OAAO;IACP,UAAU;IACV,MAAM;CACP,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,MAAM;IACN,MAAM;IACN,SAAS;IACT,WAAW;IACX,cAAc;CACf,CAAC,CAAC;AAGH,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAG3D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,qBAAqB;IACrB,0BAA0B;IAC1B,+BAA+B;IAC/B,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAc,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,IAAI,EAAE;IACR,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAClC,CAAC,CAAC"}

package/dist/templates/diataxis.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Diataxis skeleton generator for DOC items.
+ * Generates type-appropriate markdown templates when creating doc items.
+ *
+ * @see STORY-268
+ */
+import type { DiataxisType } from '../core/heuristic-classify.js';
+/**
+ * Detect Diataxis type from tags or title prefix.
+ * Returns undefined if no match found.
+ */
+export declare function detectDiataxisType(tags: readonly string[], title: string): DiataxisType | undefined;
+/**
+ * Generate a Diataxis-appropriate markdown skeleton for a doc item.
+ */
+export declare function generateDiataxisSkeleton(title: string, type: DiataxisType): string;
+//# sourceMappingURL=diataxis.d.ts.map

package/dist/templates/diataxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diataxis.d.ts","sourceRoot":"","sources":["../../src/templates/diataxis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAUlE;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAwB1B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAqIlF"}

package/dist/templates/diataxis.js

@@ -0,0 +1,176 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Diataxis skeleton generator for DOC items.
+ * Generates type-appropriate markdown templates when creating doc items.
+ *
+ * @see STORY-268
+ */
+const DIATAXIS_TITLE_PREFIXES = [
+    [/^Tutorial:\s*/i, 'tutorial'],
+    [/^How[ -]to\b/i, 'how-to'],
+    [/^Reference:\s*/i, 'reference'],
+    [/^ADR:\s*/i, 'architecture'],
+    [/^Research:\s*/i, 'research'],
+];
+/**
+ * Detect Diataxis type from tags or title prefix.
+ * Returns undefined if no match found.
+ */
+export function detectDiataxisType(tags, title) {
+    // 1. Check tags for exact Diataxis type match
+    const diataxisTypes = [
+        'tutorial',
+        'how-to',
+        'reference',
+        'explanation',
+        'architecture',
+        'research',
+    ];
+    for (const tag of tags) {
+        if (diataxisTypes.includes(tag)) {
+            return tag;
+        }
+    }
+    // 2. Check title prefix
+    for (const [pattern, type] of DIATAXIS_TITLE_PREFIXES) {
+        if (pattern.test(title)) {
+            return type;
+        }
+    }
+    return undefined;
+}
+/**
+ * Generate a Diataxis-appropriate markdown skeleton for a doc item.
+ */
+export function generateDiataxisSkeleton(title, type) {
+    switch (type) {
+        case 'tutorial':
+            return `# Tutorial: ${title}
+
+> In this tutorial, you will learn how to …
+
+## Prerequisites
+
+- …
+
+## Step 1: …
+
+Expected output:
+\`\`\`
+…
+\`\`\`
+
+## Step 2: …
+
+## Next Steps
+
+- …
+`;
+        case 'how-to':
+            return `# How to ${title}
+
+> Goal: …
+
+## Prerequisites
+
+- …
+
+## Steps
+
+1. …
+2. …
+3. …
+
+## Next Steps
+
+- …
+`;
+        case 'reference':
+            return `# Reference: ${title}
+
+## Overview
+
+…
+
+## Parameters
+
+| Name | Type | Default | Description |
+|------|------|---------|-------------|
+| … | … | … | … |
+
+## See Also
+
+- …
+`;
+        case 'explanation':
+            return `# ${title}
+
+## Background
+
+…
+
+## How It Works
+
+…
+
+## Trade-offs
+
+…
+
+## Further Reading
+
+- …
+`;
+        case 'architecture':
+            return `# ADR: ${title}
+
+## Status
+
+Proposed
+
+## Context
+
+…
+
+## Decision
+
+…
+
+## Consequences
+
+### Positive
+
+- …
+
+### Negative
+
+- …
+`;
+        case 'research':
+            return `# Research: ${title}
+
+## Question
+
+…
+
+## Methodology
+
+…
+
+## Findings
+
+…
+
+## Recommendations
+
+…
+
+## Sources
+
+- …
+`;
+    }
+}
+//# sourceMappingURL=diataxis.js.map

package/dist/templates/diataxis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diataxis.js","sourceRoot":"","sources":["../../src/templates/diataxis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,uBAAuB,GAA0C;IACrE,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC9B,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC3B,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAChC,CAAC,WAAW,EAAE,cAAc,CAAC;IAC7B,CAAC,gBAAgB,EAAE,UAAU,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,KAAa;IAEb,8CAA8C;IAC9C,MAAM,aAAa,GAAgC;QACjD,UAAU;QACV,QAAQ;QACR,WAAW;QACX,aAAa;QACb,cAAc;QACd,UAAU;KACX,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,aAAa,CAAC,QAAQ,CAAC,GAAmB,CAAC,EAAE,CAAC;YAChD,OAAO,GAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,uBAAuB,EAAE,CAAC;QACtD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,IAAkB;IACxE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,eAAe,KAAK;;;;;;;;;;;;;;;;;;;;CAoBhC,CAAC;QAEE,KAAK,QAAQ;YACX,OAAO,YAAY,KAAK;;;;;;;;;;;;;;;;;CAiB7B,CAAC;QAEE,KAAK,WAAW;YACd,OAAO,gBAAgB,KAAK;;;;;;;;;;;;;;;CAejC,CAAC;QAEE,KAAK,aAAa;YAChB,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;CAiBtB,CAAC;QAEE,KAAK,cAAc;YACjB,OAAO,UAAU,KAAK;;;;;;;;;;;;;;;;;;;;;;;CAuB3B,CAAC;QAEE,KAAK,UAAU;YACb,OAAO,eAAe,KAAK;;;;;;;;;;;;;;;;;;;;;CAqBhC,CAAC;IACA,CAAC;AACH,CAAC"}

package/dist/templates/epic.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Epic template (EPIC-059, design v6.1 §2): the sections an epic carries, the headings
+ * readers accept for each, and the skeleton `add` writes for an epic without description.
+ */
+export type EpicSectionKey = 'context' | 'user-story' | 'acceptance-criteria' | 'out-of-scope' | 'constraints' | 'working-rules';
+export interface EpicSectionSpec {
+    key: EpicSectionKey;
+    /** The heading the skeleton writes. */
+    heading: string;
+    /** Headings a reader accepts for this section, compared case-insensitively. */
+    aliases: readonly string[];
+    /** An optional section is never reported as missing. */
+    optional: boolean;
+    /** What the section holds, shown as the skeleton's placeholder. */
+    hint: string;
+}
+export declare const EPIC_SECTIONS: readonly EpicSectionSpec[];
+export declare function epicSectionSpec(key: EpicSectionKey): EpicSectionSpec;
+/**
+ * The skeleton an epic gets when it is added without a description. Placeholders are HTML
+ * comments, so an untouched section reads as empty and is still reported as missing.
+ */
+export declare function generateEpicTemplate(): string;
+//# sourceMappingURL=epic.d.ts.map