@ashlr/hub 2.2.0

package/dist/core/goals/store.js

@@ -0,0 +1,442 @@
+/**
+ * store.ts — M28: Goal record persistence for `ashlr goals`.
+ *
+ * Persists one Goal per file at ~/.ashlr/goals/<id>.json (atomic write-then-
+ * rename), mirroring the learn/quality/inbox store pattern.
+ *
+ * GUARDRAILS (paramount — see docs/contracts/CONTRACT-M28.md):
+ *  - PURE PERSISTENCE / READ-MOSTLY: this module NEVER runs a swarm, NEVER
+ *    authors a spec, NEVER touches a user repo working tree, NEVER emits an
+ *    outward action (no applyProposal, no setStatus(approved), no git push, no
+ *    createPr, no deploy). It only reads/writes JSON under ~/.ashlr/goals/.
+ *  - LOCAL-FIRST: writes ONLY under ~/.ashlr/goals/. Zero network.
+ *  - Atomic write: <id>.json.tmp then rename (POSIX-atomic).
+ *  - Never throws on read paths: list/load swallow errors and return safe
+ *    defaults ([] / null) so callers remain unblocked.
+ *  - No secrets stored: Goal/Milestone carry metadata + ids only.
+ *  - No new runtime deps; node builtins only.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { goalsDir } from '../config.js';
+// Re-export so existing importers of `goalsDir` from the store keep working;
+// the canonical definition now lives in config.ts (single source of truth for
+// the ~/.ashlr root). Re-resolved from homedir() at call time so tests that
+// relocate HOME still work.
+export { goalsDir };
+// ---------------------------------------------------------------------------
+// Bounded list cap — never read more than this many goal files at once.
+// ---------------------------------------------------------------------------
+const MAX_LIST = 200;
+// ---------------------------------------------------------------------------
+// Injectable clock (test determinism)
+// ---------------------------------------------------------------------------
+//
+// All timestamp stamping flows through nowIso(). Tests pass an explicit `now`
+// (ISO string) so metric/test paths are fully deterministic — there is NO
+// hidden nondeterminism in a stamped record.
+/** Current ISO timestamp, or the explicit override when provided (test seam). */
+function nowIso(now) {
+    return now ?? new Date().toISOString();
+}
+// ---------------------------------------------------------------------------
+// Path helpers (re-resolved at call time so tests can relocate HOME)
+// ---------------------------------------------------------------------------
+/**
+ * Absolute path to a specific goal file. Validates the id charset (mirrors the
+ * swarm store) so the store is self-defending against path traversal
+ * regardless of how a caller derived the id. Allowed: word chars, dot, hyphen.
+ *
+ * @throws when `id` contains anything outside [\w.-].
+ */
+function goalPath(dir, id) {
+    if (!/^[\w.-]+$/.test(id))
+        throw new Error(`Invalid goal id: ${id}`);
+    return join(dir, `${id}.json`);
+}
+/** Ensure the goals directory exists, silently creating it if needed. */
+function ensureDir(dir) {
+    try {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+/**
+ * Derive a stable slug from text: lowercase, words joined with hyphens, max 48
+ * chars, alphanumeric + hyphens only (mirrors spec-store's slugify).
+ */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .slice(0, 48)
+        .replace(/-$/, '');
+}
+/**
+ * Generate a stable, readable, filename-safe goal id derived from the
+ * objective (slug + short hash), mirroring spec-store's generateSpecId so two
+ * similar objectives don't silently collide.
+ */
+function generateGoalId(objective) {
+    const slug = slugify(objective) || 'goal';
+    const hash = createHash('sha256').update(objective).digest('hex').slice(0, 6);
+    return `${slug}-${hash}`;
+}
+/** Generate a stable milestone id unique within its goal (e.g. `${goalId}-m<order>`). */
+function generateMilestoneId(goalId, order) {
+    return `${goalId}-m${order}`;
+}
+// ---------------------------------------------------------------------------
+// Structural validation
+// ---------------------------------------------------------------------------
+/** Light type-guard so we never return garbage from the store. */
+function isValidGoal(parsed) {
+    if (typeof parsed !== 'object' || parsed === null)
+        return false;
+    const g = parsed;
+    return (typeof g['id'] === 'string' &&
+        typeof g['objective'] === 'string' &&
+        typeof g['status'] === 'string' &&
+        Array.isArray(g['milestones']));
+}
+// ---------------------------------------------------------------------------
+// Status roll-up — derive a goal's status from its milestones.
+// ---------------------------------------------------------------------------
+/**
+ * Re-roll a goal's status from its milestones. Preserves an explicit human
+ * 'paused' / 'archived' (those are sticky human states the mutators set/clear
+ * directly). Otherwise: 'planning' when no milestones, 'done' when every
+ * non-skipped milestone is 'done', else 'active'.
+ */
+function rollGoalStatus(goal) {
+    if (goal.status === 'paused' || goal.status === 'archived')
+        return goal.status;
+    if (goal.milestones.length === 0)
+        return 'planning';
+    const live = goal.milestones.filter((m) => m.status !== 'skipped');
+    if (live.length > 0 && live.every((m) => m.status === 'done'))
+        return 'done';
+    return 'active';
+}
+/** Sort milestones in place by ascending `order` (stable). */
+function sortMilestones(goal) {
+    goal.milestones.sort((a, b) => a.order - b.order);
+}
+// ---------------------------------------------------------------------------
+// CRUD — Goal records
+// ---------------------------------------------------------------------------
+/**
+ * Create a new Goal from an objective, persist it, and return it.
+ *
+ * Assigns a fresh id, status 'planning', empty milestones, and createdAt/
+ * updatedAt timestamps. `project` (when given) MUST already be a resolved,
+ * ENROLLED absolute repo path — enrollment is enforced by the CLI/advance
+ * path, NOT here; this is pure persistence.
+ *
+ * NEVER runs a swarm, authors a spec, or emits an outward action. Best-effort
+ * persistence (returns the in-memory Goal even if the write fails).
+ */
+export function createGoal(objective, opts) {
+    const now = nowIso(opts?.now);
+    const goal = {
+        id: generateGoalId(objective),
+        objective,
+        project: opts?.project ?? null,
+        status: 'planning',
+        milestones: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+    saveGoal(goal, { now });
+    return goal;
+}
+/**
+ * Load a single Goal by id. Returns null when absent, unreadable, or malformed.
+ * Read-only. Never throws.
+ */
+export function loadGoal(id) {
+    try {
+        const file = goalPath(goalsDir(), id);
+        if (!existsSync(file))
+            return null;
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        if (!isValidGoal(parsed))
+            return null;
+        sortMilestones(parsed);
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all persisted Goals, most-recent first by updatedAt (bounded MAX_LIST).
+ * Skips .tmp sidecars and unreadable/corrupt files. Read-only. Never throws.
+ */
+export function listGoals(filter) {
+    try {
+        const dir = goalsDir();
+        if (!existsSync(dir))
+            return [];
+        const files = readdirSync(dir)
+            .filter((f) => f.endsWith('.json') && !f.endsWith('.tmp'))
+            .slice(0, MAX_LIST);
+        const goals = [];
+        for (const f of files) {
+            try {
+                const parsed = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+                if (isValidGoal(parsed)) {
+                    sortMilestones(parsed);
+                    goals.push(parsed);
+                }
+            }
+            catch {
+                /* skip corrupt file */
+            }
+        }
+        const filtered = filter?.status !== undefined ? goals.filter((g) => g.status === filter.status) : goals;
+        // Newest-first by updatedAt; tiebreak on id so same-ms records order stably.
+        filtered.sort((a, b) => {
+            if (a.updatedAt < b.updatedAt)
+                return 1;
+            if (a.updatedAt > b.updatedAt)
+                return -1;
+            if (a.id < b.id)
+                return 1;
+            if (a.id > b.id)
+                return -1;
+            return 0;
+        });
+        return filtered;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Persist a Goal record atomically (tmp-write + rename). Bumps updatedAt.
+ * Best-effort; never throws (mirrors the swarm/inbox stores).
+ */
+export function saveGoal(goal, opts) {
+    try {
+        const dir = goalsDir();
+        ensureDir(dir);
+        goal.updatedAt = nowIso(opts?.now);
+        sortMilestones(goal);
+        const target = goalPath(dir, goal.id);
+        const tmp = `${target}.tmp`;
+        writeFileSync(tmp, JSON.stringify(goal, null, 2), 'utf8');
+        renameSync(tmp, target);
+    }
+    catch {
+        /* best-effort persistence */
+    }
+}
+/**
+ * Delete a Goal record by id. Idempotent — deleting an absent goal is a no-op.
+ * Pure FS under ~/.ashlr/goals; never touches a user repo. Never throws.
+ */
+export function deleteGoal(id) {
+    try {
+        unlinkSync(goalPath(goalsDir(), id));
+    }
+    catch {
+        /* idempotent no-op */
+    }
+}
+// ---------------------------------------------------------------------------
+// Milestone mutators — the human's STEERING controls.
+//
+// Each mutator loads the goal, mutates milestones IN MEMORY, re-sorts by order,
+// re-rolls the goal status, and saveGoal()s. None of them runs a swarm or
+// emits an outward action — they are pure local edits to the plan.
+// ---------------------------------------------------------------------------
+/**
+ * Append a new Milestone to a Goal (status 'pending', specId/swarmId/proposalId
+ * null) at the end of the current order. Returns the updated Goal, or null if
+ * the goal does not exist. Used by planner.decomposeGoal to materialize a plan.
+ */
+export function addMilestone(goalId, milestone, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const now = nowIso(opts?.now);
+    const nextOrder = goal.milestones.length === 0
+        ? 0
+        : Math.max(...goal.milestones.map((m) => m.order)) + 1;
+    goal.milestones.push({
+        id: generateMilestoneId(goalId, nextOrder),
+        title: milestone.title,
+        detail: milestone.detail,
+        order: nextOrder,
+        status: 'pending',
+        specId: null,
+        swarmId: null,
+        proposalId: null,
+        createdAt: now,
+        updatedAt: now,
+    });
+    goal.status = rollGoalStatus(goal);
+    saveGoal(goal, { now });
+    return goal;
+}
+/**
+ * Set a milestone's status (and optionally link swarmId/proposalId/specId).
+ * This is the ONLY way the advance path records progress (pending ->
+ * in-progress -> proposed, or -> blocked). Returns the updated Goal, or null
+ * if not found.
+ *
+ * NOTE: this mutates the M28 Goal record ONLY — it NEVER calls inbox setStatus
+ * and NEVER approves/applies the linked proposal.
+ */
+export function updateMilestoneStatus(goalId, milestoneId, status, link) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const m = goal.milestones.find((x) => x.id === milestoneId);
+    if (!m)
+        return null;
+    const now = nowIso(link?.now);
+    m.status = status;
+    if (link) {
+        if (link.swarmId !== undefined)
+            m.swarmId = link.swarmId;
+        if (link.proposalId !== undefined)
+            m.proposalId = link.proposalId;
+        if (link.specId !== undefined)
+            m.specId = link.specId;
+    }
+    m.updatedAt = now;
+    goal.status = rollGoalStatus(goal);
+    saveGoal(goal, { now });
+    return goal;
+}
+/**
+ * Clear ALL of a goal's milestones, returning it to a fresh, unplanned state
+ * (status re-rolled to 'planning'). Used by the CLI `goals plan --replace` to
+ * support an explicit, destructive re-plan WITHOUT duplicating the milestone
+ * set. Pure local edit under ~/.ashlr/goals — never runs a swarm, never touches
+ * a user repo, never approves/applies a proposal. Returns the updated Goal, or
+ * null if not found.
+ */
+export function clearMilestones(goalId, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    goal.milestones = [];
+    goal.status = rollGoalStatus(goal);
+    saveGoal(goal, { now: opts?.now });
+    return goal;
+}
+/**
+ * Reorder a goal's milestones to match the given id sequence (any ids omitted
+ * keep their relative order after the listed ones). Rewrites `order` keys and
+ * re-sorts. Returns the updated Goal, or null if not found.
+ */
+export function reorderMilestones(goalId, orderedIds, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const rank = new Map();
+    orderedIds.forEach((id, i) => rank.set(id, i));
+    // Listed ids first (in the given order), then the rest in their current order.
+    const reordered = [...goal.milestones].sort((a, b) => {
+        const ra = rank.has(a.id) ? rank.get(a.id) : Number.MAX_SAFE_INTEGER;
+        const rb = rank.has(b.id) ? rank.get(b.id) : Number.MAX_SAFE_INTEGER;
+        if (ra !== rb)
+            return ra - rb;
+        return a.order - b.order;
+    });
+    reordered.forEach((m, i) => {
+        m.order = i;
+    });
+    goal.milestones = reordered;
+    saveGoal(goal, { now: opts?.now });
+    return goal;
+}
+/**
+ * Pause a single milestone (status 'paused') or, when milestoneId is omitted,
+ * pause the WHOLE goal (goal.status 'paused' — no milestone advances). A paused
+ * milestone is skipped by nextActionableMilestone(). Returns updated Goal/null.
+ */
+export function pauseMilestone(goalId, milestoneId, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const now = nowIso(opts?.now);
+    if (milestoneId) {
+        const m = goal.milestones.find((x) => x.id === milestoneId);
+        if (!m)
+            return null;
+        m.status = 'paused';
+        m.updatedAt = now;
+        goal.status = rollGoalStatus(goal);
+    }
+    else {
+        goal.status = 'paused';
+    }
+    saveGoal(goal, { now });
+    return goal;
+}
+/**
+ * Resume a milestone back to 'pending' or, when milestoneId is omitted, resume
+ * the WHOLE goal (re-roll goal.status). A milestone is resumable when it is
+ * 'paused' (human steering) OR 'blocked' (a prior advance that threw / needs
+ * recovery) — both transition back to 'pending' so it can be re-advanced. This
+ * is the recovery path out of the 'blocked' state the advance error-handler
+ * sets. Returns updated Goal/null.
+ */
+export function resumeMilestone(goalId, milestoneId, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const now = nowIso(opts?.now);
+    if (milestoneId) {
+        const m = goal.milestones.find((x) => x.id === milestoneId);
+        if (!m)
+            return null;
+        if (m.status === 'paused' || m.status === 'blocked') {
+            m.status = 'pending';
+            m.updatedAt = now;
+        }
+        if (goal.status !== 'archived')
+            goal.status = rollGoalStatus(goal);
+    }
+    else {
+        // Resume the whole goal: clear the sticky 'paused' so rollGoalStatus recomputes.
+        if (goal.status === 'paused')
+            goal.status = 'planning';
+        goal.status = rollGoalStatus(goal);
+    }
+    saveGoal(goal, { now });
+    return goal;
+}
+/**
+ * Skip a milestone permanently (status 'skipped'); it is excluded from progress
+ * denominators and never advanced. Returns updated Goal, or null if not found.
+ */
+export function skipMilestone(goalId, milestoneId, opts) {
+    const goal = loadGoal(goalId);
+    if (!goal)
+        return null;
+    const m = goal.milestones.find((x) => x.id === milestoneId);
+    if (!m)
+        return null;
+    const now = nowIso(opts?.now);
+    m.status = 'skipped';
+    m.updatedAt = now;
+    goal.status = rollGoalStatus(goal);
+    saveGoal(goal, { now });
+    return goal;
+}
+//# sourceMappingURL=store.js.map

package/dist/core/goals/store.js.map

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

package/dist/core/inbox/apply.d.ts

@@ -0,0 +1,36 @@
+/**
+ * core/inbox/apply.ts — The ONLY outward mutation path in v2 (M23).
+ *
+ * applyProposal is the single funnel for every outward action. It is called
+ * ONLY from `cli/inbox.ts` after the user explicitly runs `inbox approve <id>`
+ * (with confirm or --yes). It is NEVER called automatically, never on create,
+ * never on list/show, never by the daemon.
+ *
+ * GUARDRAILS:
+ *  - REFUSE unless proposal exists AND status==='approved' AND confirmed===true.
+ *  - assertMayMutate(repo) before any mutation (enrollment + kill switch).
+ *  - 'patch': apply diff on a NEW branch (ashlr/proposal/<id>) off HEAD.
+ *    NEVER touch the user's current branch/index/working tree.
+ *    NEVER force. NEVER push. Local only.
+ *  - 'pr': branch + commit, then the gated M18 createPr.
+ *  - 'deploy': gated ship path.
+ *  - 'note': no-op record.
+ *  - Every attempt is audited. Status set to 'applied'/'failed' + result.
+ *  - Never throws out — all failures returned as ApplyResult.
+ *  - No secrets in proposals/audit.
+ *  - No new runtime deps; node builtins only.
+ */
+import type { ApplyResult } from '../types.js';
+/**
+ * Apply an approved proposal. This is the ONLY outward mutation path in v2.
+ *
+ * REFUSES (ok:false, mutates nothing) unless ALL hold:
+ *   1. Proposal exists (loadProposal !== null)
+ *   2. proposal.status === 'approved'
+ *   3. opts.confirmed === true
+ *
+ * Never throws — all failures returned as ApplyResult with status 'failed'.
+ */
+export declare function applyProposal(id: string, opts: {
+    confirmed: boolean;
+}): Promise<ApplyResult>;