@kernloop/faculty-scrum 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 William Zujkowski and Kernloop contributors
+
+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/dist/decompose.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Program goal decomposition — the MECHANICAL half, ONE ALTITUDE UP from the
+ * PM's plan decomposition (spec §5.4; CLM-0096). Where faculty-workforce's
+ * `decomposePlan` splits a ratified plan into agent-assigned children, this
+ * splits a program GOAL into an epic/story TaskContract tree, tagging each
+ * child with its program altitude/track/sprint as constraint tags.
+ *
+ * No model is ever called here: a PM model WRITES the story specs upstream;
+ * this function takes them as plain input and enforces the contract — schema
+ * validity, id/parent/overlay derivation, ceiling clamping, the budget-sum
+ * invariant, and well-formed constraint tags. The invariant is therefore
+ * unit-testable without any model in the loop. This faculty imports only
+ * @kernloop/contracts and zod (constitutional rule 5).
+ */
+import { type TaskContract } from '@kernloop/contracts';
+import { z } from 'zod';
+/**
+ * One story (or sub-epic) as proposed by the PM. Identity, overlay, and
+ * authority are NOT inputs — they are derived from the parent here, so a PM
+ * cannot grant what the parent does not hold. `altitude` is the child's
+ * program rung (e.g. 'epic' or 'story'); optional `track`/`sprint` group it.
+ */
+export declare const StorySpecSchema: z.ZodObject<{
+    goal: z.ZodString;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    budget: z.ZodObject<{
+        tokens: z.ZodNumber;
+        usd: z.ZodNumber;
+        wallClockMin: z.ZodNumber;
+    }, z.core.$strict>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            test: "test";
+            ci: "ci";
+            doc: "doc";
+            eval: "eval";
+        }>;
+        ref: z.ZodString;
+    }, z.core.$strict>>>;
+    definitionOfDone: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+    }, z.core.$strict>>>;
+    assignTo: z.ZodEnum<{
+        pm: "pm";
+        coder: "coder";
+        reviewer: "reviewer";
+        documenter: "documenter";
+        researcher: "researcher";
+    }>;
+    altitude: z.ZodEnum<{
+        epic: "epic";
+        story: "story";
+        task: "task";
+    }>;
+    track: z.ZodOptional<z.ZodString>;
+    sprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type StorySpec = z.infer<typeof StorySpecSchema>;
+/** Input to {@link decomposeGoal}. */
+export interface DecomposeGoalInput {
+    parent: TaskContract;
+    subtasks: StorySpec[];
+}
+/**
+ * Derive zod-valid child TaskContracts from a program parent plus PM-proposed
+ * story specs, ONE ALTITUDE UP from `decomposePlan` (CLM-0096). Enforces:
+ *
+ * - ALTITUDE DESCENT: when the parent carries an `altitude`, it decomposes
+ *   exactly one rung down (epic→story, story→task) and a `task` parent is a
+ *   leaf that cannot decompose — a violation throws {@link AltitudeDescentError}.
+ *   A parent with no altitude (the program root) is the unconstrained entry.
+ * - BUDGET INVARIANT: child budgets sum within the parent's on each of tokens,
+ *   usd, and wallClockMin independently; any breach throws
+ *   {@link ScrumBudgetExceededError} naming the dimension and amounts. An exact
+ *   sum is within budget. Zero/negative child slices are rejected.
+ * - Identity: `child.id = parent.id + '.<n>'` (1-based input order),
+ *   `child.parent = parent.id`, `child.overlay = parent.overlay`.
+ * - Authority: `child.authorityCeiling = min(parent ceiling, 'suggest')` — a PM
+ *   cannot grant authority the parent does not hold, and generative program
+ *   work enters at `suggest` (spec §3.2).
+ * - Constraints: parent constraints bind children, then the story's own, then
+ *   the program tags `altitude:<v>` (+ optional `track:`/`sprint:`), then the
+ *   routing tag `assign:agent.<template>`. Emitted tags are validated via
+ *   {@link parseConstraintTags} so an unsafe value cannot escape.
+ */
+export declare function decomposeGoal(input: DecomposeGoalInput): TaskContract[];
+//# sourceMappingURL=decompose.d.ts.map

package/dist/decompose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompose.d.ts","sourceRoot":"","sources":["../src/decompose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAOL,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2CxB;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAc1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAsFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAmBvE"}

package/dist/decompose.js

@@ -0,0 +1,188 @@
+/**
+ * Program goal decomposition — the MECHANICAL half, ONE ALTITUDE UP from the
+ * PM's plan decomposition (spec §5.4; CLM-0096). Where faculty-workforce's
+ * `decomposePlan` splits a ratified plan into agent-assigned children, this
+ * splits a program GOAL into an epic/story TaskContract tree, tagging each
+ * child with its program altitude/track/sprint as constraint tags.
+ *
+ * No model is ever called here: a PM model WRITES the story specs upstream;
+ * this function takes them as plain input and enforces the contract — schema
+ * validity, id/parent/overlay derivation, ceiling clamping, the budget-sum
+ * invariant, and well-formed constraint tags. The invariant is therefore
+ * unit-testable without any model in the loop. This faculty imports only
+ * @kernloop/contracts and zod (constitutional rule 5).
+ */
+import { AltitudeSchema, TaskContractSchema, TierSchema, constraintTag, parseConstraintTags, } from '@kernloop/contracts';
+import { z } from 'zod';
+import { AltitudeDescentError, InvalidParentError, InvalidStorySpecError, ScrumBudgetExceededError, } from './errors.js';
+/** The altitude exactly one rung below a decomposable parent (the descent
+ * ladder epic → story → task). A `task` is a leaf (no rung below). */
+const CHILD_ALTITUDE = {
+    epic: 'story',
+    story: 'task',
+    task: undefined,
+};
+/** Authority ladder, lowest first (spec §3.2). */
+const TIER_ORDER = TierSchema.options;
+/** The lower of two tiers on the ladder. */
+function minTier(a, b) {
+    return TIER_ORDER.indexOf(a) <= TIER_ORDER.indexOf(b) ? a : b;
+}
+/**
+ * The shipped agent-template names a story may be assigned to. Inlined rather
+ * than imported from @kernloop/faculty-workforce — a faculty→faculty import is
+ * forbidden (constitutional rule 5). Mirrors workforce's `SHIPPED_TEMPLATE_NAMES`;
+ * custom templates are a later increment (deferred: #177).
+ */
+const STORY_ASSIGNEES = ['pm', 'coder', 'reviewer', 'documenter', 'researcher'];
+/**
+ * A child budget as proposed. Stricter than TaskContract's nonnegative budget:
+ * a zero or negative slice on any dimension is rejected — a child with nothing
+ * to spend is a stub, and stubs are forbidden.
+ */
+const StoryBudgetSchema = z.strictObject({
+    tokens: z.number().int().positive(),
+    usd: z.number().positive(),
+    wallClockMin: z.number().positive(),
+});
+/**
+ * One story (or sub-epic) as proposed by the PM. Identity, overlay, and
+ * authority are NOT inputs — they are derived from the parent here, so a PM
+ * cannot grant what the parent does not hold. `altitude` is the child's
+ * program rung (e.g. 'epic' or 'story'); optional `track`/`sprint` group it.
+ */
+export const StorySpecSchema = z.strictObject({
+    goal: z.string().min(1),
+    constraints: z.array(z.string().min(1)).optional(),
+    budget: StoryBudgetSchema,
+    evidence: TaskContractSchema.shape.evidence.optional(),
+    definitionOfDone: TaskContractSchema.shape.definitionOfDone.optional(),
+    /** Shipped template name this child is assigned to (custom templates: later). */
+    assignTo: z.enum(STORY_ASSIGNEES),
+    /** The child's program altitude — epic | story | task. */
+    altitude: AltitudeSchema,
+    /** Optional track grouping (safe label charset, enforced on emit). */
+    track: z.string().optional(),
+    /** Optional sprint grouping (safe label charset, enforced on emit). */
+    sprint: z.string().optional(),
+});
+/** Parse one story spec, wrapping any schema failure as a typed error. */
+function parseStory(spec, index) {
+    const parsed = StorySpecSchema.safeParse(spec);
+    if (!parsed.success) {
+        throw new InvalidStorySpecError(index, z.prettifyError(parsed.error));
+    }
+    return parsed.data;
+}
+/**
+ * Enforce altitude descent (CLM-0096): when the parent carries an `altitude`
+ * tag, it must decompose exactly one rung down — `epic`→`story`, `story`→`task`
+ * — and a `task` parent is a leaf that cannot be decomposed at all. A parent
+ * with NO altitude is the program root (the unconstrained entry) and is not
+ * checked, so the model still chooses the entry granularity. A child whose
+ * altitude is not exactly the expected rung throws {@link AltitudeDescentError}.
+ */
+function checkAltitudeDescent(parentAltitude, stories) {
+    if (parentAltitude === undefined)
+        return; // root entry — unconstrained
+    const expected = CHILD_ALTITUDE[parentAltitude];
+    if (expected === undefined) {
+        throw new AltitudeDescentError(parentAltitude, -1); // a task is a leaf
+    }
+    stories.forEach((spec, index) => {
+        if (spec.altitude !== expected) {
+            throw new AltitudeDescentError(parentAltitude, index, expected, spec.altitude);
+        }
+    });
+}
+/** Enforce sum(child) ≤ parent independently per budget dimension. */
+function checkBudgetInvariant(parent, stories) {
+    for (const dimension of ['tokens', 'usd', 'wallClockMin']) {
+        const childSum = stories.reduce((sum, s) => sum + s.budget[dimension], 0);
+        if (childSum > parent.budget[dimension]) {
+            throw new ScrumBudgetExceededError(dimension, parent.budget[dimension], childSum);
+        }
+    }
+}
+/** Build a child's constraint array: the parent's FREE-FORM constraints
+ * (`inherited`, its program tags stripped) + the story's own + the child's
+ * freshly-derived altitude/track/sprint + assignment. The parent's own program
+ * tags are NOT inherited — re-deriving them per child is what lets an
+ * altitude-bearing parent decompose without a duplicate `altitude:` tag. */
+function childConstraints(inherited, spec) {
+    return [
+        ...inherited,
+        ...(spec.constraints ?? []),
+        constraintTag('altitude', spec.altitude),
+        ...(spec.track !== undefined ? [constraintTag('track', spec.track)] : []),
+        ...(spec.sprint !== undefined ? [constraintTag('sprint', spec.sprint)] : []),
+        constraintTag('assign', `agent.${spec.assignTo}`),
+    ];
+}
+/** Map one validated story spec to a zod-valid child TaskContract. */
+function toChild(parent, inherited, spec, index) {
+    const constraints = childConstraints(inherited, spec);
+    // Defense in depth: the emitted program tags must read back cleanly — an
+    // unsafe track/sprint or bad altitude surfaces here as a typed story error.
+    try {
+        parseConstraintTags(constraints);
+    }
+    catch (error) {
+        throw new InvalidStorySpecError(index, error instanceof Error ? error.message : String(error));
+    }
+    return TaskContractSchema.parse({
+        id: `${parent.id}.${index + 1}`,
+        parent: parent.id,
+        goal: spec.goal,
+        constraints,
+        budget: spec.budget,
+        evidence: spec.evidence ?? [],
+        definitionOfDone: spec.definitionOfDone ?? [],
+        authorityCeiling: minTier(parent.authorityCeiling, 'suggest'),
+        overlay: parent.overlay,
+    });
+}
+/**
+ * Derive zod-valid child TaskContracts from a program parent plus PM-proposed
+ * story specs, ONE ALTITUDE UP from `decomposePlan` (CLM-0096). Enforces:
+ *
+ * - ALTITUDE DESCENT: when the parent carries an `altitude`, it decomposes
+ *   exactly one rung down (epic→story, story→task) and a `task` parent is a
+ *   leaf that cannot decompose — a violation throws {@link AltitudeDescentError}.
+ *   A parent with no altitude (the program root) is the unconstrained entry.
+ * - BUDGET INVARIANT: child budgets sum within the parent's on each of tokens,
+ *   usd, and wallClockMin independently; any breach throws
+ *   {@link ScrumBudgetExceededError} naming the dimension and amounts. An exact
+ *   sum is within budget. Zero/negative child slices are rejected.
+ * - Identity: `child.id = parent.id + '.<n>'` (1-based input order),
+ *   `child.parent = parent.id`, `child.overlay = parent.overlay`.
+ * - Authority: `child.authorityCeiling = min(parent ceiling, 'suggest')` — a PM
+ *   cannot grant authority the parent does not hold, and generative program
+ *   work enters at `suggest` (spec §3.2).
+ * - Constraints: parent constraints bind children, then the story's own, then
+ *   the program tags `altitude:<v>` (+ optional `track:`/`sprint:`), then the
+ *   routing tag `assign:agent.<template>`. Emitted tags are validated via
+ *   {@link parseConstraintTags} so an unsafe value cannot escape.
+ */
+export function decomposeGoal(input) {
+    const parentResult = TaskContractSchema.safeParse(input.parent);
+    if (!parentResult.success) {
+        throw new InvalidParentError(z.prettifyError(parentResult.error));
+    }
+    const parent = parentResult.data;
+    // Parse the parent's program tags ONCE: its altitude drives descent, and its
+    // free-form (non-tag) constraints are what children inherit. A malformed
+    // parent tag is a typed InvalidParentError, never a raw throw.
+    let parentTags;
+    try {
+        parentTags = parseConstraintTags(parent.constraints);
+    }
+    catch (error) {
+        throw new InvalidParentError(error instanceof Error ? error.message : String(error));
+    }
+    const stories = input.subtasks.map((spec, i) => parseStory(spec, i));
+    checkAltitudeDescent(parentTags.altitude, stories);
+    checkBudgetInvariant(parent, stories);
+    return stories.map((spec, i) => toChild(parent, parentTags.other, spec, i));
+}
+//# sourceMappingURL=decompose.js.map

package/dist/decompose.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Typed errors thrown at the scrum faculty's boundaries. Callers discriminate
+ * on `name` or `instanceof` — never on message text. Mirrors the shapes of
+ * faculty-workforce's decomposition errors (spec §5.4).
+ */
+import type { Altitude, TaskContract } from '@kernloop/contracts';
+/** The three independently-summed budget dimensions of a TaskContract. */
+export type BudgetDimension = keyof TaskContract['budget'];
+/**
+ * Thrown when the sum of child (story) budgets exceeds the parent budget on
+ * any dimension (spec §5.4: child TaskContract budgets "must sum within the
+ * parent's"; CLM-0096). Carries the offending dimension and both amounts so a
+ * caller can report — or replan — without parsing text.
+ */
+export declare class ScrumBudgetExceededError extends Error {
+    readonly dimension: BudgetDimension;
+    readonly parentAmount: number;
+    readonly childSum: number;
+    constructor(dimension: BudgetDimension, parentAmount: number, childSum: number);
+}
+/**
+ * Thrown when the parent contract handed to decomposeGoal fails
+ * TaskContractSchema validation (charter: zod-validate at every contract
+ * boundary).
+ */
+export declare class InvalidParentError extends Error {
+    constructor(detail: string);
+}
+/**
+ * Thrown when a story spec is malformed for a reason other than the budget-sum
+ * invariant: schema violation, zero/negative budget dimension, an `assignTo`
+ * naming no shipped template, or an `altitude` outside the enum.
+ */
+export declare class InvalidStorySpecError extends Error {
+    /** Zero-based index of the offending story in the input array. */
+    readonly index: number;
+    constructor(index: number, detail: string);
+}
+/**
+ * Thrown when a decomposition violates altitude descent (spec §5.4; CLM-0096):
+ * an altitude-bearing parent must decompose exactly ONE rung down (epic→story,
+ * story→task), and a `task`-altitude parent is a LEAF that cannot decompose at
+ * all. (A parent with no altitude — the program root — is the unconstrained
+ * entry and is not checked.) Carries the parent + expected/actual child
+ * altitudes so a caller can report or replan without parsing text. For a
+ * task-parent leaf violation, `expected`/`actual` are omitted.
+ */
+export declare class AltitudeDescentError extends Error {
+    readonly parentAltitude: Altitude;
+    readonly expected?: Altitude;
+    readonly actual?: Altitude;
+    /** Zero-based index of the offending child, or -1 for a task-leaf parent. */
+    readonly index: number;
+    constructor(parentAltitude: Altitude, index: number, expected?: Altitude, actual?: Altitude);
+}
+/**
+ * Thrown by {@link programLabels} when an emitted label would not satisfy the
+ * tracker's label charset. Unreachable from valid decomposed input (altitude is
+ * an enum; track/sprint/assign are charset-bound upstream) — it is a typed
+ * invariant guard so a FUTURE label source that slips an unsafe value surfaces
+ * as a clean, discriminable error rather than escaping as a raw throw.
+ */
+export declare class UnsafeLabelError extends Error {
+    constructor(label: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAElE,0EAA0E;AAC1E,MAAM,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU/E;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,MAAM,EAAE,MAAM;CAI3B;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK1C;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ;CAa5F;AAED;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,MAAM;CAI1B"}

package/dist/errors.js

@@ -0,0 +1,87 @@
+/**
+ * Thrown when the sum of child (story) budgets exceeds the parent budget on
+ * any dimension (spec §5.4: child TaskContract budgets "must sum within the
+ * parent's"; CLM-0096). Carries the offending dimension and both amounts so a
+ * caller can report — or replan — without parsing text.
+ */
+export class ScrumBudgetExceededError extends Error {
+    dimension;
+    parentAmount;
+    childSum;
+    constructor(dimension, parentAmount, childSum) {
+        super(`child budgets exceed parent on ${dimension}: ` +
+            `sum ${childSum} > parent ${parentAmount} (spec §5.4)`);
+        this.name = 'ScrumBudgetExceededError';
+        this.dimension = dimension;
+        this.parentAmount = parentAmount;
+        this.childSum = childSum;
+    }
+}
+/**
+ * Thrown when the parent contract handed to decomposeGoal fails
+ * TaskContractSchema validation (charter: zod-validate at every contract
+ * boundary).
+ */
+export class InvalidParentError extends Error {
+    constructor(detail) {
+        super(detail);
+        this.name = 'InvalidParentError';
+    }
+}
+/**
+ * Thrown when a story spec is malformed for a reason other than the budget-sum
+ * invariant: schema violation, zero/negative budget dimension, an `assignTo`
+ * naming no shipped template, or an `altitude` outside the enum.
+ */
+export class InvalidStorySpecError extends Error {
+    /** Zero-based index of the offending story in the input array. */
+    index;
+    constructor(index, detail) {
+        super(`story[${index}]: ${detail}`);
+        this.name = 'InvalidStorySpecError';
+        this.index = index;
+    }
+}
+/**
+ * Thrown when a decomposition violates altitude descent (spec §5.4; CLM-0096):
+ * an altitude-bearing parent must decompose exactly ONE rung down (epic→story,
+ * story→task), and a `task`-altitude parent is a LEAF that cannot decompose at
+ * all. (A parent with no altitude — the program root — is the unconstrained
+ * entry and is not checked.) Carries the parent + expected/actual child
+ * altitudes so a caller can report or replan without parsing text. For a
+ * task-parent leaf violation, `expected`/`actual` are omitted.
+ */
+export class AltitudeDescentError extends Error {
+    parentAltitude;
+    expected;
+    actual;
+    /** Zero-based index of the offending child, or -1 for a task-leaf parent. */
+    index;
+    constructor(parentAltitude, index, expected, actual) {
+        super(expected === undefined
+            ? `a "${parentAltitude}" is a leaf and cannot be decomposed (spec §5.4)`
+            : `story[${index}]: altitude "${actual ?? '<missing>'}" violates descent — ` +
+                `a "${parentAltitude}" parent decomposes to "${expected}" children (spec §5.4)`);
+        this.name = 'AltitudeDescentError';
+        this.parentAltitude = parentAltitude;
+        this.index = index;
+        if (expected !== undefined)
+            this.expected = expected;
+        if (actual !== undefined)
+            this.actual = actual;
+    }
+}
+/**
+ * Thrown by {@link programLabels} when an emitted label would not satisfy the
+ * tracker's label charset. Unreachable from valid decomposed input (altitude is
+ * an enum; track/sprint/assign are charset-bound upstream) — it is a typed
+ * invariant guard so a FUTURE label source that slips an unsafe value surfaces
+ * as a clean, discriminable error rather than escaping as a raw throw.
+ */
+export class UnsafeLabelError extends Error {
+    constructor(label) {
+        super(`program label "${label}" is not tracker-label-safe`);
+        this.name = 'UnsafeLabelError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACxC,SAAS,CAAkB;IAC3B,YAAY,CAAS;IACrB,QAAQ,CAAS;IAE1B,YAAY,SAA0B,EAAE,YAAoB,EAAE,QAAgB;QAC5E,KAAK,CACH,kCAAkC,SAAS,IAAI;YAC7C,OAAO,QAAQ,aAAa,YAAY,cAAc,CACzD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,kEAAkE;IACzD,KAAK,CAAS;IAEvB,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CAAC,SAAS,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,cAAc,CAAW;IACzB,QAAQ,CAAY;IACpB,MAAM,CAAY;IAC3B,6EAA6E;IACpE,KAAK,CAAS;IAEvB,YAAY,cAAwB,EAAE,KAAa,EAAE,QAAmB,EAAE,MAAiB;QACzF,KAAK,CACH,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,MAAM,cAAc,kDAAkD;YACxE,CAAC,CAAC,SAAS,KAAK,gBAAgB,MAAM,IAAI,WAAW,uBAAuB;gBACxE,MAAM,cAAc,2BAA2B,QAAQ,wBAAwB,CACtF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACrD,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjD,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,KAAa;QACvB,KAAK,CAAC,kBAAkB,KAAK,6BAA6B,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @kernloop/faculty-scrum — the scrum/program-decomposition faculty (spec §5.4).
+ *
+ * Decomposes a program goal into an epic/story TaskContract tree ONE ALTITUDE
+ * UP from the PM's plan decomposition: child budgets must sum within the
+ * parent's on every dimension (the budget-sum invariant), and each child
+ * carries its program altitude/track/sprint as constraint tags (CLM-0096).
+ * GitHub-free and model-free — generative work happens elsewhere; this package
+ * is pure mechanical enforcement, surfaced through the suggest-tier
+ * `kernloop program decompose` CLI. It imports only @kernloop/contracts and
+ * external dependencies (constitutional rule 5).
+ */
+export { decomposeGoal, StorySpecSchema } from './decompose.js';
+export type { StorySpec, DecomposeGoalInput } from './decompose.js';
+export { programLabels, programIssueBody } from './labels.js';
+export { AltitudeDescentError, InvalidParentError, InvalidStorySpecError, ScrumBudgetExceededError, UnsafeLabelError, } from './errors.js';
+export type { BudgetDimension } from './errors.js';
+export { scrumManifest } from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @kernloop/faculty-scrum — the scrum/program-decomposition faculty (spec §5.4).
+ *
+ * Decomposes a program goal into an epic/story TaskContract tree ONE ALTITUDE
+ * UP from the PM's plan decomposition: child budgets must sum within the
+ * parent's on every dimension (the budget-sum invariant), and each child
+ * carries its program altitude/track/sprint as constraint tags (CLM-0096).
+ * GitHub-free and model-free — generative work happens elsewhere; this package
+ * is pure mechanical enforcement, surfaced through the suggest-tier
+ * `kernloop program decompose` CLI. It imports only @kernloop/contracts and
+ * external dependencies (constitutional rule 5).
+ */
+export { decomposeGoal, StorySpecSchema } from './decompose.js';
+export { programLabels, programIssueBody } from './labels.js';
+export { AltitudeDescentError, InvalidParentError, InvalidStorySpecError, ScrumBudgetExceededError, UnsafeLabelError, } from './errors.js';
+export { scrumManifest } from './manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/labels.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The constraint-tag → GitHub-label map + issue-body rendering for program
+ * emission (spec §5.4; CLM-0097). The half of `kernloop program emit` that is
+ * PURE and GitHub-free: it turns a decomposed child TaskContract into the
+ * label set and issue body the CLI will hand to the hardened @kernloop/tracker.
+ *
+ * Faculty isolation (constitutional rule 5): this module imports ONLY
+ * @kernloop/contracts and zod — never the tracker and never the CLI. The label
+ * charset it must satisfy (the tracker's `LabelSchema`) is therefore asserted
+ * here with an inlined copy of the same regex, not by importing the tracker.
+ */
+import { type TaskContract } from '@kernloop/contracts';
+/**
+ * Map a TaskContract's constraint tags to GitHub labels through the one
+ * `LABEL_MAP` table — so the GitHub view and future loop routing never
+ * diverge [CLM-0097]. Emits `altitude:<a>`, `track:<t>`, `sprint:<s>`, and
+ * `agent:<t>` (from `assign:agent.<t>`); free-form/unknown constraints (the
+ * `other` bucket) produce NO label. Output is deduped and every label is
+ * asserted tracker-label-safe ({@link assertLabelSafe}) before return.
+ */
+export declare function programLabels(constraints: readonly string[]): string[];
+/**
+ * Render the GitHub issue body for a decomposed child node (CLM-0097): the
+ * node goal as prose, then the replayable task-shaped payload (id, parent,
+ * goal, constraints, budget) as a fenced JSON block a human or `kernloop run`
+ * can pick up. Pure — no secrets, no tracker, no model. Mirrors the spirit of
+ * faculty-observer's `issueBody`.
+ */
+export declare function programIssueBody(node: TaskContract): string;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAwD7E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAatE;AAeD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAU3D"}

package/dist/labels.js

@@ -0,0 +1,116 @@
+/**
+ * The constraint-tag → GitHub-label map + issue-body rendering for program
+ * emission (spec §5.4; CLM-0097). The half of `kernloop program emit` that is
+ * PURE and GitHub-free: it turns a decomposed child TaskContract into the
+ * label set and issue body the CLI will hand to the hardened @kernloop/tracker.
+ *
+ * Faculty isolation (constitutional rule 5): this module imports ONLY
+ * @kernloop/contracts and zod — never the tracker and never the CLI. The label
+ * charset it must satisfy (the tracker's `LabelSchema`) is therefore asserted
+ * here with an inlined copy of the same regex, not by importing the tracker.
+ */
+import { parseConstraintTags } from '@kernloop/contracts';
+import { z } from 'zod';
+import { UnsafeLabelError } from './errors.js';
+/**
+ * The tracker `LabelSchema` charset, INLINED (faculty-scrum must not import the
+ * tracker — constitutional rule 5). Kept byte-identical to
+ * `@kernloop/tracker`'s `LabelSchema` regex (leading alphanumeric, then the
+ * `[A-Za-z0-9 _.\-/:]` charset, ≤80, no leading `-`) so a label this module
+ * emits is provably accepted at the sink. {@link assertLabelSafe} applies it.
+ */
+const LABEL_SAFE = /^[A-Za-z0-9][A-Za-z0-9 _.\-/:]*$/;
+/**
+ * Assert an emitted label satisfies the tracker's label charset (≤80, leading
+ * alphanumeric). Every value `programLabels` emits is already charset-bound
+ * upstream — altitude is the `epic|story|task` enum; track/sprint/assign are
+ * validated by `parseConstraintTags` against `[A-Za-z0-9._-]` — so this is
+ * defense in depth: a future tag source that slips an unsafe value cannot
+ * escape to `gh` as a flag-shaped label.
+ */
+function assertLabelSafe(label) {
+    if (label.length > 80 || !LABEL_SAFE.test(label)) {
+        throw new UnsafeLabelError(label);
+    }
+}
+/**
+ * THE ONE MAP: how a single program constraint tag becomes a GitHub label.
+ * Keyed by the {@link parseConstraintTags} field, each entry renders the
+ * typed value to a label string. This is the single source of truth so the
+ * GitHub view and future loop routing can never diverge on the spelling.
+ *
+ * Note the `assign` transform: `assign:agent.<t>` (the constraint carrier) maps
+ * to the label `agent:<t>` — the key changes from `assign` to `agent` and the
+ * `agent.<t>` value's `.` becomes `:`. The other three keys pass through.
+ *
+ * INCREMENT 4 (#52) NOTE: the REVERSE direction (label → tag, for loop
+ * routing) is a trivial later addition over this same table, and when the
+ * kernel/router needs it the table moves to a shared home. For now
+ * faculty-scrum is the only consumer.
+ */
+const LABEL_MAP = {
+    altitude: (v) => `altitude:${v}`,
+    track: (v) => `track:${v}`,
+    sprint: (v) => `sprint:${v}`,
+    // `assign:agent.<t>` → `agent:<t>` (drop the `assign:` prefix, `.` → `:`).
+    // Anything not of the `agent.<t>` shape produces no label (skipped).
+    assign: (v) => (v.startsWith('agent.') ? `agent:${v.slice('agent.'.length)}` : undefined),
+};
+/**
+ * Map a TaskContract's constraint tags to GitHub labels through the one
+ * `LABEL_MAP` table — so the GitHub view and future loop routing never
+ * diverge [CLM-0097]. Emits `altitude:<a>`, `track:<t>`, `sprint:<s>`, and
+ * `agent:<t>` (from `assign:agent.<t>`); free-form/unknown constraints (the
+ * `other` bucket) produce NO label. Output is deduped and every label is
+ * asserted tracker-label-safe ({@link assertLabelSafe}) before return.
+ */
+export function programLabels(constraints) {
+    const tags = parseConstraintTags(constraints);
+    const out = [];
+    if (tags.altitude !== undefined)
+        out.push(LABEL_MAP.altitude(tags.altitude));
+    if (tags.track !== undefined)
+        out.push(LABEL_MAP.track(tags.track));
+    if (tags.sprint !== undefined)
+        out.push(LABEL_MAP.sprint(tags.sprint));
+    if (tags.assign !== undefined) {
+        const label = LABEL_MAP.assign(tags.assign);
+        if (label !== undefined)
+            out.push(label);
+    }
+    const deduped = [...new Set(out)];
+    for (const label of deduped)
+        assertLabelSafe(label);
+    return deduped;
+}
+/** The replayable, task-shaped payload embedded in a program issue body. */
+const PayloadSchema = z.strictObject({
+    id: z.string(),
+    parent: z.string().optional(),
+    goal: z.string(),
+    constraints: z.array(z.string()),
+    budget: z.object({
+        tokens: z.number(),
+        usd: z.number(),
+        wallClockMin: z.number(),
+    }),
+});
+/**
+ * Render the GitHub issue body for a decomposed child node (CLM-0097): the
+ * node goal as prose, then the replayable task-shaped payload (id, parent,
+ * goal, constraints, budget) as a fenced JSON block a human or `kernloop run`
+ * can pick up. Pure — no secrets, no tracker, no model. Mirrors the spirit of
+ * faculty-observer's `issueBody`.
+ */
+export function programIssueBody(node) {
+    const payload = PayloadSchema.parse({
+        id: node.id,
+        ...(node.parent !== undefined ? { parent: node.parent } : {}),
+        goal: node.goal,
+        constraints: node.constraints,
+        budget: node.budget,
+    });
+    const json = JSON.stringify(payload, null, 2);
+    return `${node.goal}\n\n---\nTask-shaped payload — feed to \`kernloop run\` (no privileged path):\n\n\`\`\`json\n${json}\n\`\`\``;
+}
+//# sourceMappingURL=labels.js.map

package/dist/labels.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The scrum faculty's registration record (spec §4, §5.4). Parsed through
+ * `ManifestSchema` at module load so an invalid manifest fails fast, not at
+ * registry time.
+ */
+import { type Manifest } from '@kernloop/contracts';
+/**
+ * The faculty-scrum registration manifest. Tier is `suggest` — program
+ * decomposition stands behind the PM, a generative role, and anything
+ * generative enters at `suggest` (spec §3.2); promotion needs evidence +
+ * ratification. Consumes TaskContract (the program parent) and emits
+ * TaskContract (the derived epic/story children). Cost is zero tokens/usd:
+ * decomposition enforcement is mechanical — the PM's generative work runs
+ * elsewhere, where the adapters meter it. The capability has no run-executor:
+ * it is surfaced through the `kernloop program decompose` CLI verb (CLM-0096),
+ * registered here for observability and its ladder tier.
+ */
+export declare const scrumManifest: Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,EAAE,QAuB1B,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,41 @@
+/**
+ * The scrum faculty's registration record (spec §4, §5.4). Parsed through
+ * `ManifestSchema` at module load so an invalid manifest fails fast, not at
+ * registry time.
+ */
+import { ManifestSchema } from '@kernloop/contracts';
+/**
+ * The faculty-scrum registration manifest. Tier is `suggest` — program
+ * decomposition stands behind the PM, a generative role, and anything
+ * generative enters at `suggest` (spec §3.2); promotion needs evidence +
+ * ratification. Consumes TaskContract (the program parent) and emits
+ * TaskContract (the derived epic/story children). Cost is zero tokens/usd:
+ * decomposition enforcement is mechanical — the PM's generative work runs
+ * elsewhere, where the adapters meter it. The capability has no run-executor:
+ * it is surfaced through the `kernloop program decompose` CLI verb (CLM-0096),
+ * registered here for observability and its ladder tier.
+ */
+export const scrumManifest = ManifestSchema.parse({
+    name: '@kernloop/faculty-scrum',
+    version: '0.1.0',
+    kind: 'faculty',
+    capabilities: [
+        {
+            name: 'scrum.decompose-goal',
+            description: 'Decompose a program goal into an epic/story TaskContract tree under the budget-sum invariant with altitude/track/sprint tags (spec §5.4)',
+        },
+    ],
+    contracts: {
+        consumes: ['TaskContract'],
+        emits: ['TaskContract'],
+    },
+    cost: {
+        tokens: 0,
+        usd: 0,
+        latencyMs: 10,
+    },
+    tier: 'suggest',
+    claims: ['CLM-0096'],
+    maturity: 'stable',
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAa,cAAc,CAAC,KAAK,CAAC;IAC1D,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,SAAS;IACf,YAAY,EAAE;QACZ;YACE,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EACT,0IAA0I;SAC7I;KACF;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,KAAK,EAAE,CAAC,cAAc,CAAC;KACxB;IACD,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC;QACT,GAAG,EAAE,CAAC;QACN,SAAS,EAAE,EAAE;KACd;IACD,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,CAAC,UAAU,CAAC;IACpB,QAAQ,EAAE,QAAQ;CACnB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@kernloop/faculty-scrum",
+  "version": "0.1.0",
+  "description": "Kernloop scrum/program-decomposition faculty (spec §5.4). Decomposes a goal into an epic/story TaskContract tree one altitude up from the PM's plan decomposition: child budgets must sum within the parent's on every dimension, and each child carries altitude/track/sprint constraint tags. GitHub-free and model-free — pure, mechanical decomposition surfaced through the suggest-tier `kernloop program decompose` CLI.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@kernloop/contracts": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kernloop/kernloop.git",
+    "directory": "packages/faculty-scrum"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run --coverage"
+  }
+}