@aperant/framework 0.6.2

package/dist/cli/skill-author/skill-template.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template.mjs","sourceRoot":"","sources":["../../../src/cli/skill-author/skill-template.mjs"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;IACpD,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAA;IAC9B,OAAO;QACA,QAAQ;eACD,WAAW;;;;;;;;;kBASR,QAAQ;;;;;;;OAOnB,QAAQ;MACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDb,CAAA;AACD,CAAC"}

package/dist/cli/skill-author/test-template.d.mts

@@ -0,0 +1,19 @@
+/**
+ * skill-author/test-template.mjs — C4 structural-test renderer.
+ *
+ * Pure function. Returns the TypeScript source of a per-skill structural test
+ * file mirroring packages/framework/src/__tests__/apt-design-skill-structure.test.ts.
+ *
+ * The generated test is intentionally minimal: it pins the contract basics
+ * (frontmatter name, four required section tags) so the skill immediately has
+ * a drift-detector after scaffold. Authors can extend the generated test with
+ * skill-specific assertions once the SKILL.md body is fleshed out.
+ */
+/**
+ * @param {{ name: string }} opts — name is the kebab slug AFTER `apt:`
+ * @returns {string} TypeScript source
+ */
+export function renderStructuralTest({ name }: {
+    name: string;
+}): string;
+//# sourceMappingURL=test-template.d.mts.map

package/dist/cli/skill-author/test-template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-template.d.mts","sourceRoot":"","sources":["../../../src/cli/skill-author/test-template.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,+CAHW;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACd,MAAM,CAyClB"}

package/dist/cli/skill-author/test-template.mjs

@@ -0,0 +1,56 @@
+/**
+ * skill-author/test-template.mjs — C4 structural-test renderer.
+ *
+ * Pure function. Returns the TypeScript source of a per-skill structural test
+ * file mirroring packages/framework/src/__tests__/apt-design-skill-structure.test.ts.
+ *
+ * The generated test is intentionally minimal: it pins the contract basics
+ * (frontmatter name, four required section tags) so the skill immediately has
+ * a drift-detector after scaffold. Authors can extend the generated test with
+ * skill-specific assertions once the SKILL.md body is fleshed out.
+ */
+/**
+ * @param {{ name: string }} opts — name is the kebab slug AFTER `apt:`
+ * @returns {string} TypeScript source
+ */
+export function renderStructuralTest({ name }) {
+    const fullName = `apt:${name}`;
+    const skillDir = `apt-${name}`;
+    const describeTitle = `${fullName} SKILL.md structure`;
+    return `/**
+ * apt-${name}-skill-structure.test.ts — structural test for the ${fullName} skill.
+ *
+ * Generated by \`apt-tools author-skill ${name}\`. Pins the canonical SKILL.md
+ * contract (C4) at author-time: frontmatter name + the four required section
+ * tags. Extend with skill-specific assertions as the SKILL.md body is filled in.
+ */
+
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { describe, expect, it } from 'vitest'
+
+// __dirname = packages/framework/src/__tests__ → ../.. = packages/framework
+const FRAMEWORK_ROOT = resolve(__dirname, '..', '..')
+const SKILL_PATH = resolve(FRAMEWORK_ROOT, 'skills/${skillDir}/SKILL.md')
+
+describe('${describeTitle}', () => {
+	it('exists and has the expected frontmatter name', () => {
+		const contents = readFileSync(SKILL_PATH, 'utf-8')
+		expect(contents).toMatch(/^---\\n[\\s\\S]*?name:\\s*${fullName}/m)
+	})
+
+	it('contains <objective>, <your_environment>, <state_files>, <process> sections', () => {
+		const contents = readFileSync(SKILL_PATH, 'utf-8')
+		expect(contents).toContain('<objective>')
+		expect(contents).toContain('</objective>')
+		expect(contents).toContain('<your_environment>')
+		expect(contents).toContain('</your_environment>')
+		expect(contents).toContain('<state_files>')
+		expect(contents).toContain('</state_files>')
+		expect(contents).toContain('<process>')
+		expect(contents).toContain('</process>')
+	})
+})
+`;
+}
+//# sourceMappingURL=test-template.mjs.map

package/dist/cli/skill-author/test-template.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-template.mjs","sourceRoot":"","sources":["../../../src/cli/skill-author/test-template.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,IAAI,EAAE;IAC5C,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAA;IAC9B,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAA;IAC9B,MAAM,aAAa,GAAG,GAAG,QAAQ,qBAAqB,CAAA;IACtD,OAAO;SACC,IAAI,sDAAsD,QAAQ;;2CAEhC,IAAI;;;;;;;;;;;qDAWM,QAAQ;;YAEjD,aAAa;;;wDAG+B,QAAQ;;;;;;;;;;;;;;;CAe/D,CAAA;AACD,CAAC"}

package/dist/cli/skill-author/validate.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @typedef {{ ok: boolean, errors: string[], warnings: string[] }} ValidationResult
+ */
+/**
+ * Validate a SKILL.md's raw text against the canonical contract.
+ *
+ * @param {string} text — full SKILL.md contents, including frontmatter
+ * @returns {ValidationResult}
+ */
+export function validateSkillMarkdown(text: string): ValidationResult;
+export type ValidationResult = {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+};
+//# sourceMappingURL=validate.d.mts.map

package/dist/cli/skill-author/validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.mts","sourceRoot":"","sources":["../../../src/cli/skill-author/validate.mjs"],"names":[],"mappings":"AAsBA;;GAEG;AAEH;;;;;GAKG;AACH,4CAHW,MAAM,GACJ,gBAAgB,CAgG5B;+BAvGY;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE"}

package/dist/cli/skill-author/validate.mjs

@@ -0,0 +1,114 @@
+/**
+ * skill-author/validate.mjs — C4 SKILL.md validator (pure fn).
+ *
+ * Grep-style validation that mirrors the rigor of the existing per-skill
+ * structural tests (see apt-design-skill-structure.test.ts). We do NOT build
+ * a full markdown AST — we check:
+ *
+ *   1. YAML frontmatter block is parseable + passes SkillFrontmatterSchema.
+ *   2. Every REQUIRED_SECTIONS tag has a matching opening + closing pair.
+ *   3. The <process> body contains at least two numbered step headings
+ *      (`## 1. Foo`, `## 2. Bar`, ...) with monotonic numbering from 1.
+ *   4. Soft-required tags either present or emit a warning.
+ *
+ * Returns { ok, errors, warnings } — callers decide whether to treat warnings
+ * as a hard failure (the integration smoke test does; the CLI does not).
+ */
+import { parse as parseYaml } from 'yaml';
+import { REQUIRED_SECTIONS, SOFT_REQUIRED_SECTIONS, validateFrontmatter } from './contract.mjs';
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
+/**
+ * @typedef {{ ok: boolean, errors: string[], warnings: string[] }} ValidationResult
+ */
+/**
+ * Validate a SKILL.md's raw text against the canonical contract.
+ *
+ * @param {string} text — full SKILL.md contents, including frontmatter
+ * @returns {ValidationResult}
+ */
+export function validateSkillMarkdown(text) {
+    const errors = [];
+    const warnings = [];
+    if (typeof text !== 'string' || text.length === 0) {
+        return { ok: false, errors: ['SKILL.md is empty or not a string'], warnings };
+    }
+    // --- Frontmatter ---------------------------------------------------------
+    const fmMatch = text.match(FRONTMATTER_RE);
+    if (!fmMatch) {
+        errors.push('missing YAML frontmatter block (must start with `---\\n...\\n---\\n`)');
+    }
+    else {
+        let parsed;
+        try {
+            parsed = parseYaml(fmMatch[1]);
+        }
+        catch (err) {
+            errors.push(`frontmatter YAML parse error: ${(err && err.message) || String(err)}`);
+            parsed = null;
+        }
+        if (parsed !== null) {
+            if (parsed === undefined || typeof parsed !== 'object') {
+                errors.push('frontmatter must be a YAML object');
+            }
+            else {
+                const res = validateFrontmatter(parsed);
+                if (!res.success) {
+                    for (const issue of res.error.issues) {
+                        const pathStr = issue.path && issue.path.length > 0 ? issue.path.join('.') : '(root)';
+                        errors.push(`frontmatter.${pathStr}: ${issue.message}`);
+                    }
+                }
+            }
+        }
+    }
+    // --- Required section tags ----------------------------------------------
+    for (const tag of REQUIRED_SECTIONS) {
+        const closing = tag.replace('<', '</');
+        if (!text.includes(tag)) {
+            errors.push(`missing required opening tag ${tag}`);
+        }
+        if (!text.includes(closing)) {
+            errors.push(`missing required closing tag ${closing}`);
+        }
+    }
+    // --- Process block shape (numbered steps, monotonic from 1) --------------
+    const processMatch = text.match(/<process>([\s\S]*?)<\/process>/);
+    if (processMatch) {
+        const body = processMatch[1];
+        const stepRe = /^##\s+(\d+(?:\.\d+)?)\.\s+/gm;
+        const steps = [];
+        let m;
+        m = stepRe.exec(body);
+        while (m !== null) {
+            steps.push(m[1]);
+            m = stepRe.exec(body);
+        }
+        if (steps.length < 2) {
+            errors.push(`<process> must contain at least two numbered step headings (e.g. "## 1. Load Context"); found ${steps.length}`);
+        }
+        else {
+            // Monotonic-from-1 check is a warning, not an error — apt:design
+            // uses "## 2b. Render TASTE_BLOCK" and similar sub-step notation
+            // that is legitimate but not strictly monotonic.
+            const primaryNumbers = steps.map((s) => Number.parseInt(String(s).split('.')[0], 10));
+            if (primaryNumbers[0] !== 1) {
+                warnings.push(`<process> first step number is ${primaryNumbers[0]} but should be 1 for readability`);
+            }
+            for (let i = 1; i < primaryNumbers.length; i++) {
+                const prev = primaryNumbers[i - 1];
+                const cur = primaryNumbers[i];
+                if (cur !== prev && cur !== prev + 1) {
+                    warnings.push(`<process> step numbering jumps from ${prev} to ${cur}; prefer consecutive integers`);
+                }
+            }
+        }
+    }
+    // --- Soft-required tags (warnings only) ---------------------------------
+    for (const tag of SOFT_REQUIRED_SECTIONS) {
+        if (!text.includes(tag)) {
+            warnings.push(`missing soft-required tag ${tag} — consider adding one for better agent behavior (see docs/skill-authoring.md)`);
+        }
+    }
+    return { ok: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=validate.mjs.map

package/dist/cli/skill-author/validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.mjs","sourceRoot":"","sources":["../../../src/cli/skill-author/validate.mjs"],"names":[],"mappings":"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"}

package/dist/cli/task/build-progress-sync.d.mts

@@ -0,0 +1,44 @@
+/**
+ * Split a subtask id on `+` into its constituent ids. Deduplicates, preserves
+ * order. Throws on empty-string input, empty fragments, or fragments that
+ * don't match a known id shape.
+ */
+export function parseConsolidatedId(id: any): string[];
+/**
+ * Atomic: append to build-progress.json + flip plan subtasks to completed.
+ *
+ * @param {object} args
+ * @param {string} args.projectDir
+ * @param {string} args.taskId
+ * @param {string} args.subtaskId          may be "E1+E2" consolidated
+ * @param {string} [args.commit]           commit sha
+ * @param {string} [args.notes]
+ * @param {string} [args.completedAt]      test hook; overrides new Date().toISOString()
+ *
+ * @returns {{
+ *   status: 'ok',
+ *   task_id: string,
+ *   subtask_id: string,
+ *   constituent_ids: string[],
+ *   plan_updates: number,
+ *   progress_updates: number,
+ *   already_complete?: boolean
+ * }}
+ */
+export function completeSubtask({ projectDir, taskId, subtaskId, commit, notes, completedAt }: {
+    projectDir: string;
+    taskId: string;
+    subtaskId: string;
+    commit?: string | undefined;
+    notes?: string | undefined;
+    completedAt?: string | undefined;
+}): {
+    status: "ok";
+    task_id: string;
+    subtask_id: string;
+    constituent_ids: string[];
+    plan_updates: number;
+    progress_updates: number;
+    already_complete?: boolean;
+};
+//# sourceMappingURL=build-progress-sync.d.mts.map

package/dist/cli/task/build-progress-sync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-progress-sync.d.mts","sourceRoot":"","sources":["../../../src/cli/task/build-progress-sync.mjs"],"names":[],"mappings":"AAsCA;;;;GAIG;AACH,uDAuBC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,+FAjBG;IAAqB,UAAU,EAAvB,MAAM;IACO,MAAM,EAAnB,MAAM;IACO,SAAS,EAAtB,MAAM;IACQ,MAAM;IACN,KAAK;IACL,WAAW;CAEjC,GAAU;IACR,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAqHH"}

package/dist/cli/task/build-progress-sync.mjs

@@ -0,0 +1,194 @@
+/**
+ * @internal
+ * build-progress-sync.mjs — atomic plan ↔ build-progress sync (C33).
+ *
+ * Closes the gap from the 19-04-26 pipeline-harness task where
+ * `build-progress.json.completed_subtasks` was updated but
+ * `implementation_plan.json.subtasks[].status` was not, so the hard-gate
+ * `all-subtasks-complete` check had to be force-bypassed to ship.
+ *
+ * Public surface:
+ *   - `parseConsolidatedId(id)`: expands an id like "E1+E2+F3" into
+ *     ["E1","E2","F3"]. Validates each fragment against id patterns seen
+ *     across the framework + throws on empty/malformed fragments.
+ *   - `completeSubtask({projectDir, taskId, subtaskId, commit, notes})`:
+ *     atomically appends to build-progress.json AND flips plan subtask
+ *     status(es) to "completed". Idempotent — re-running for an
+ *     already-complete subtask returns `{status:'ok', already_complete:true}`.
+ *
+ * Atomicity: the write holds a file lock on the build-progress.json path
+ * (matches the existing task.mjs `withFileLock(statePath)` pattern) and uses
+ * `atomicWriteJson` for tmp-file + fsync + rename on both JSON files. The
+ * plan file is NOT locked separately — locking the same path across both
+ * writes would require a second lock (with deadlock risk); instead, we write
+ * plan → progress last so an interruption leaves progress file unchanged and
+ * the operation is safe to retry.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { withFileLock } from '../util/fs-lock.mjs';
+import { atomicWriteJson } from '../util/io.mjs';
+// Accept the id patterns we've seen in real plans:
+//   - `A1`, `E12`, `H1`    (letter prefix + digits)
+//   - `s1`, `s-1`, `sub-1`, `sub-1-2`  (legacy / generator-specific)
+//   - `1`, `12`            (bare digits)
+const ID_FRAGMENT_REGEX = /^(?:[A-Za-z]+\d+|\d+|s-?\d+|sub-?\d+(?:-\d+)*)$/;
+/**
+ * Split a subtask id on `+` into its constituent ids. Deduplicates, preserves
+ * order. Throws on empty-string input, empty fragments, or fragments that
+ * don't match a known id shape.
+ */
+export function parseConsolidatedId(id) {
+    if (typeof id !== 'string') {
+        throw new Error(`parseConsolidatedId: expected string, got ${typeof id}`);
+    }
+    const trimmed = id.trim();
+    if (trimmed === '') {
+        throw new Error('parseConsolidatedId: empty id');
+    }
+    const parts = trimmed.split('+').map((s) => s.trim());
+    const seen = new Set();
+    const out = [];
+    for (const part of parts) {
+        if (part === '') {
+            throw new Error(`parseConsolidatedId: empty fragment in "${id}"`);
+        }
+        if (!ID_FRAGMENT_REGEX.test(part)) {
+            throw new Error(`parseConsolidatedId: invalid fragment "${part}" in "${id}"`);
+        }
+        if (seen.has(part))
+            continue;
+        seen.add(part);
+        out.push(part);
+    }
+    return out;
+}
+/**
+ * Atomic: append to build-progress.json + flip plan subtasks to completed.
+ *
+ * @param {object} args
+ * @param {string} args.projectDir
+ * @param {string} args.taskId
+ * @param {string} args.subtaskId          may be "E1+E2" consolidated
+ * @param {string} [args.commit]           commit sha
+ * @param {string} [args.notes]
+ * @param {string} [args.completedAt]      test hook; overrides new Date().toISOString()
+ *
+ * @returns {{
+ *   status: 'ok',
+ *   task_id: string,
+ *   subtask_id: string,
+ *   constituent_ids: string[],
+ *   plan_updates: number,
+ *   progress_updates: number,
+ *   already_complete?: boolean
+ * }}
+ */
+export function completeSubtask({ projectDir, taskId, subtaskId, commit, notes, completedAt }) {
+    if (!projectDir)
+        throw new Error('completeSubtask: projectDir required');
+    if (!taskId)
+        throw new Error('completeSubtask: taskId required');
+    if (!subtaskId)
+        throw new Error('completeSubtask: subtaskId required');
+    const taskDir = join(projectDir, '.aperant', 'tasks', taskId);
+    const planPath = join(taskDir, 'implementation_plan.json');
+    const progressPath = join(taskDir, 'build-progress.json');
+    if (!existsSync(planPath)) {
+        throw new Error(`completeSubtask: plan not found at ${planPath}`);
+    }
+    const constituents = parseConsolidatedId(subtaskId);
+    const isConsolidated = constituents.length > 1 || subtaskId.includes('+');
+    return withFileLock(progressPath, () => {
+        const plan = JSON.parse(readFileSync(planPath, 'utf-8'));
+        const progress = existsSync(progressPath)
+            ? JSON.parse(readFileSync(progressPath, 'utf-8'))
+            : {
+                task_id: taskId,
+                completed_subtasks: [],
+                pending_subtasks: [],
+            };
+        if (!Array.isArray(progress.completed_subtasks))
+            progress.completed_subtasks = [];
+        // Idempotency: if the subtask id is already in completed_subtasks,
+        // don't double-append. Accept either the literal consolidated id OR
+        // the case where all constituents already appear as individual ids.
+        const alreadyLiteral = progress.completed_subtasks.some((e) => e && e.id === subtaskId);
+        const alreadyAllConstituents = constituents.length > 0 &&
+            constituents.every((cid) => progress.completed_subtasks.some((e) => {
+                if (!e)
+                    return false;
+                if (e.id === cid)
+                    return true;
+                const cids = Array.isArray(e.constituent_ids) ? e.constituent_ids : [];
+                return cids.includes(cid);
+            }));
+        if (alreadyLiteral || alreadyAllConstituents) {
+            return {
+                status: 'ok',
+                task_id: taskId,
+                subtask_id: subtaskId,
+                constituent_ids: constituents,
+                plan_updates: 0,
+                progress_updates: 0,
+                already_complete: true,
+            };
+        }
+        // Flip matching plan subtasks to completed. Unknown ids fail loud —
+        // don't silently skip; a mistyped id should surface immediately.
+        if (!Array.isArray(plan.subtasks)) {
+            throw new Error(`completeSubtask: plan.subtasks is not an array in ${planPath}`);
+        }
+        const planById = new Map(plan.subtasks.map((st) => [st.id, st]));
+        const unknown = constituents.filter((cid) => !planById.has(cid));
+        if (unknown.length > 0) {
+            throw new Error(`completeSubtask: constituent id(s) not in plan: ${unknown.join(', ')} (plan=${planPath})`);
+        }
+        let planUpdates = 0;
+        for (const cid of constituents) {
+            const st = planById.get(cid);
+            if (st.status !== 'completed') {
+                st.status = 'completed';
+                planUpdates += 1;
+            }
+        }
+        // Append the build-progress entry.
+        const at = completedAt || new Date().toISOString();
+        const entry = {
+            id: subtaskId,
+            completed_at: at,
+        };
+        if (commit)
+            entry.commit = commit;
+        if (notes)
+            entry.notes = notes;
+        if (isConsolidated)
+            entry.constituent_ids = constituents;
+        progress.completed_subtasks.push(entry);
+        progress.task_id = progress.task_id || taskId;
+        progress.last_updated = at;
+        // Maintain pending_subtasks if the caller tracks it.
+        if (Array.isArray(progress.pending_subtasks)) {
+            const pending = new Set(progress.pending_subtasks);
+            for (const cid of constituents)
+                pending.delete(cid);
+            // Consolidated literal too (so the progress list stays clean).
+            pending.delete(subtaskId);
+            progress.pending_subtasks = Array.from(pending);
+        }
+        // Write plan first, then progress. An interruption between the two
+        // leaves the plan ahead of progress; the next call is safe because
+        // the idempotency check catches the constituents already flipped.
+        atomicWriteJson(planPath, plan);
+        atomicWriteJson(progressPath, progress);
+        return {
+            status: 'ok',
+            task_id: taskId,
+            subtask_id: subtaskId,
+            constituent_ids: constituents,
+            plan_updates: planUpdates,
+            progress_updates: 1,
+        };
+    }, { projectRoot: projectDir });
+}
+//# sourceMappingURL=build-progress-sync.mjs.map

package/dist/cli/task/build-progress-sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-progress-sync.mjs","sourceRoot":"","sources":["../../../src/cli/task/build-progress-sync.mjs"],"names":[],"mappings":"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"}

package/dist/cli/task/execution-mode.d.mts

@@ -0,0 +1,19 @@
+/** True when `value` is one of the persisted execution-mode values. */
+export function isValidExecutionMode(value: any): boolean;
+/** Comma-separated list for usage messages. */
+export function executionModesList(): string;
+/**
+ * task/execution-mode.mjs — canonical execution-mode validation (C21).
+ *
+ * Single source of truth for the set of valid `execution_mode` values written
+ * onto task records and accepted by the router's `--execution-mode` flag.
+ * `ask` is intentionally excluded — it's the implicit no-pre-pick value, not
+ * something a caller persists.
+ *
+ * Imported by:
+ *   - commands/route.mjs        (--execution-mode override validation)
+ *   - commands/task.mjs         (task create / update --execution-mode)
+ *   - commands/plan-approval.mjs (no — it doesn't validate the mode itself)
+ */
+export const VALID_EXECUTION_MODES: readonly string[];
+//# sourceMappingURL=execution-mode.d.mts.map

package/dist/cli/task/execution-mode.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-mode.d.mts","sourceRoot":"","sources":["../../../src/cli/task/execution-mode.mjs"],"names":[],"mappings":"AAwBA,uEAAuE;AACvE,0DAEC;AAED,+CAA+C;AAC/C,6CAEC;AAhCD;;;;;;;;;;;;GAYG;AAEH,sDAME"}

package/dist/cli/task/execution-mode.mjs

@@ -0,0 +1,30 @@
+/**
+ * task/execution-mode.mjs — canonical execution-mode validation (C21).
+ *
+ * Single source of truth for the set of valid `execution_mode` values written
+ * onto task records and accepted by the router's `--execution-mode` flag.
+ * `ask` is intentionally excluded — it's the implicit no-pre-pick value, not
+ * something a caller persists.
+ *
+ * Imported by:
+ *   - commands/route.mjs        (--execution-mode override validation)
+ *   - commands/task.mjs         (task create / update --execution-mode)
+ *   - commands/plan-approval.mjs (no — it doesn't validate the mode itself)
+ */
+export const VALID_EXECUTION_MODES = Object.freeze([
+    'auto',
+    'step',
+    'plan-only',
+    'plan-mode',
+    'research',
+]);
+const VALID_SET = new Set(VALID_EXECUTION_MODES);
+/** True when `value` is one of the persisted execution-mode values. */
+export function isValidExecutionMode(value) {
+    return typeof value === 'string' && VALID_SET.has(value);
+}
+/** Comma-separated list for usage messages. */
+export function executionModesList() {
+    return VALID_EXECUTION_MODES.join(', ');
+}
+//# sourceMappingURL=execution-mode.mjs.map

package/dist/cli/task/execution-mode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-mode.mjs","sourceRoot":"","sources":["../../../src/cli/task/execution-mode.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM;IACN,MAAM;IACN,WAAW;IACX,WAAW;IACX,UAAU;CACV,CAAC,CAAA;AAEF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAA;AAEhD,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,KAAK;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AACzD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB;IACjC,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC"}

package/dist/cli/task/format.d.mts

@@ -0,0 +1,8 @@
+/**
+ * format.mjs — date/time display formatters for INDEX.md (C29).
+ */
+/** Format date for display in INDEX.md */
+export function formatDateDisplay(date: any, format: any): string;
+/** Format time for display in INDEX.md */
+export function formatTimeDisplay(date: any, format: any): string;
+//# sourceMappingURL=format.d.mts.map

package/dist/cli/task/format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.mts","sourceRoot":"","sources":["../../../src/cli/task/format.mjs"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,kEAaC;AAED,0CAA0C;AAC1C,kEASC"}

package/dist/cli/task/format.mjs

@@ -0,0 +1,30 @@
+/**
+ * format.mjs — date/time display formatters for INDEX.md (C29).
+ */
+/** Format date for display in INDEX.md */
+export function formatDateDisplay(date, format) {
+    const yy = String(date.getFullYear()).slice(2);
+    const mm = String(date.getMonth() + 1).padStart(2, '0');
+    const dd = String(date.getDate()).padStart(2, '0');
+    switch (format) {
+        case 'DD-MM-YY':
+            return `${dd}/${mm}/${yy}`;
+        case 'MM-DD-YY':
+            return `${mm}/${dd}/${yy}`;
+        case 'YY-MM-DD':
+        default:
+            return `${yy}/${mm}/${dd}`;
+    }
+}
+/** Format time for display in INDEX.md */
+export function formatTimeDisplay(date, format) {
+    const h = date.getHours();
+    const m = String(date.getMinutes()).padStart(2, '0');
+    if (format === '12h') {
+        const period = h >= 12 ? 'PM' : 'AM';
+        const h12 = h % 12 || 12;
+        return `${h12}:${m} ${period}`;
+    }
+    return `${String(h).padStart(2, '0')}:${m}`;
+}
+//# sourceMappingURL=format.mjs.map

package/dist/cli/task/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","sourceRoot":"","sources":["../../../src/cli/task/format.mjs"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,MAAM,UAAU,iBAAiB,CAAC,IAAI,EAAE,MAAM;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACvD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAClD,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,UAAU;YACd,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;QAC3B,KAAK,UAAU;YACd,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;QAC3B,KAAK,UAAU,CAAC;QAChB;YACC,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;IAC5B,CAAC;AACF,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,iBAAiB,CAAC,IAAI,EAAE,MAAM;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IACzB,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACpD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QACpC,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;QACxB,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,MAAM,EAAE,CAAA;IAC/B,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;AAC5C,CAAC"}

package/dist/cli/task/ids.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Format a date according to user preferences.
+ * Supported formats: YY-MM-DD (default, sorts chronologically), DD-MM-YY, MM-DD-YY
+ * Uses hyphens as separators for filesystem safety.
+ */
+export function formatDateForTask(dateFormat: any): string;
+/**
+ * Generate a short task ID from description + timestamp.
+ * Format: {date}_{slug}-{4-char-hash}
+ * Date comes first so tasks sort chronologically in file explorers.
+ * Date format is configurable via preferences.date_format in config.
+ */
+export function generateTaskId(description: any, config: any): string;
+export function getTaskDir(projectDir: any, taskId: any): string;
+/**
+ * C28 — scope-aware proof directory.
+ * Returns `.aperant/proof/{scope}/{task-id}/` for proof evidence that belongs
+ * to a specific task. Callers pass the task's scope (from state.active_tasks)
+ * so unseeded tasks default cleanly.
+ */
+export function getProofDir(projectDir: any, scope: any, taskId: any): string;
+//# sourceMappingURL=ids.d.mts.map

package/dist/cli/task/ids.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.mts","sourceRoot":"","sources":["../../../src/cli/task/ids.mjs"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,2DAcC;AAED;;;;;GAKG;AACH,sEAUC;AAED,iEAEC;AAED;;;;;GAKG;AACH,8EAGC"}