ftown-bridge 0.19.37 → 0.19.39

package/dist/loop-store.js

@@ -1,153 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { v4 as uuidv4 } from 'uuid';
-import { computeNextRun } from './loop-schedule.js';
-let configuredFtownHome;
-/** Inject the instance ".ftown home" once at startup (see module doc). */
-export function configureLoopStoreHome(home) {
-    configuredFtownHome = home;
-}
-function ftownHome() {
-    return configuredFtownHome ?? join(homedir(), '.ftown');
-}
-function loopsPath() {
-    return join(ftownHome(), 'loops.json');
-}
-/** Tolerant loader: returns { loops: [] } on a missing OR corrupt file. Never throws. */
-function loadLoops() {
-    try {
-        const path = loopsPath();
-        if (!existsSync(path))
-            return { loops: [] };
-        const parsed = JSON.parse(readFileSync(path, 'utf8'));
-        return { loops: Array.isArray(parsed.loops) ? parsed.loops : [] };
-    }
-    catch {
-        return { loops: [] };
-    }
-}
-function saveLoops(data) {
-    mkdirSync(ftownHome(), { recursive: true, mode: 0o700 });
-    const path = loopsPath();
-    const tmp = `${path}.tmp`;
-    writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
-    renameSync(tmp, path); // atomic
-}
-/** Trim `group`; blank/whitespace-only collapses to undefined (field absent). */
-function normalizeGroup(group) {
-    const trimmed = group?.trim();
-    return trimmed ? trimmed : undefined;
-}
-export function listLoops() {
-    return loadLoops().loops;
-}
-export function getLoop(id) {
-    return loadLoops().loops.find((loop) => loop.id === id);
-}
-/**
- * Mint a Loop from a client draft: fresh id/timestamps, zeroed counters, and a
- * nextRunAt computed from now — even when created disabled, so re-enabling has a
- * target. Throws (via computeNextRun) on a malformed cron expression.
- */
-export function createLoop(draft) {
-    const data = loadLoops();
-    const now = new Date();
-    const loop = {
-        ...draft,
-        id: uuidv4(),
-        createdAt: now.toISOString(),
-        updatedAt: now.toISOString(),
-        nextRunAt: new Date(computeNextRun(draft.schedule, now.getTime())).toISOString(),
-        runCount: 0,
-        skipCount: 0,
-    };
-    const group = normalizeGroup(draft.group);
-    if (group)
-        loop.group = group;
-    else
-        delete loop.group;
-    data.loops.push(loop);
-    saveLoops(data);
-    return loop;
-}
-/**
- * Merge `patch` over an existing loop. id + createdAt are immutable; updatedAt is
- * bumped. A schedule change recomputes nextRunAt from now (the old target is
- * stale). Returns null when no loop has that id.
- */
-export function updateLoop(id, patch) {
-    const data = loadLoops();
-    const index = data.loops.findIndex((loop) => loop.id === id);
-    if (index === -1)
-        return null;
-    const existing = data.loops[index];
-    const updated = {
-        ...existing,
-        ...patch,
-        id: existing.id,
-        // A loop is owned by exactly one bridge (the one it is persisted on); its
-        // bridgeId is the RPC routing key. Never let a patch move it — a stray
-        // patch.bridgeId would otherwise desync the record from the routing guard.
-        bridgeId: existing.bridgeId,
-        createdAt: existing.createdAt,
-        updatedAt: new Date().toISOString(),
-    };
-    if (patch.schedule) {
-        updated.nextRunAt = new Date(computeNextRun(updated.schedule, Date.now())).toISOString();
-    }
-    if ('group' in patch) {
-        const group = normalizeGroup(patch.group);
-        if (group)
-            updated.group = group;
-        else
-            delete updated.group;
-    }
-    data.loops[index] = updated;
-    saveLoops(data);
-    return updated;
-}
-export function deleteLoop(id) {
-    const data = loadLoops();
-    const remaining = data.loops.filter((loop) => loop.id !== id);
-    if (remaining.length === data.loops.length)
-        return false;
-    data.loops = remaining;
-    saveLoops(data);
-    return true;
-}
-/** Insert a loop, or replace the existing one with the same id, in place. */
-export function upsertLoop(loop) {
-    const data = loadLoops();
-    const index = data.loops.findIndex((existing) => existing.id === loop.id);
-    if (index === -1)
-        data.loops.push(loop);
-    else
-        data.loops[index] = loop;
-    saveLoops(data);
-}
-/**
- * Atomically apply a scheduler-owned mutation: reload the loop FRESH from disk,
- * apply `fn`, then save. Returns the merged loop, or null when the id no longer
- * exists (deleted concurrently) — the caller then skips its publish so a deleted
- * loop is never resurrected.
- *
- * The scheduler holds a detached Loop snapshot across long awaits (a 20s
- * preflight, an in-process spawn). Writing that whole stale snapshot back would
- * (a) resurrect a loop deleted mid-flight and (b) clobber a concurrent
- * update_loop patch to user-owned fields. Because `fn` runs on the
- * freshly-loaded record and touches only runtime fields, both hazards are gone:
- * a delete wins (null), and an unrelated enabled/schedule/task patch survives.
- */
-export function mutateLoopRuntime(id, fn) {
-    const data = loadLoops();
-    const index = data.loops.findIndex((loop) => loop.id === id);
-    if (index === -1)
-        return null;
-    const loop = data.loops[index];
-    fn(loop);
-    data.loops[index] = loop;
-    saveLoops(data);
-    return loop;
-}
-//# sourceMappingURL=loop-store.js.map

package/dist/loop-store.js.map

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

package/dist/loop-validation.d.ts

@@ -1,15 +0,0 @@
-import type { LoopDraft, LoopSchedule } from './types.js';
-/**
- * Loop payload validation, extracted from index.ts so it is unit-testable
- * without importing the CLI entrypoint (which calls program.parse() on load).
- * Every validator returns an error string, or null when the input is valid.
- */
-/** Derived from the harness registry — the harnesses with validForLoop. */
-export declare const LOOP_HARNESSES: ReadonlySet<string>;
-/** Validate a loop schedule (interval floor + cron parseability). */
-export declare function validateSchedule(schedule: LoopSchedule | undefined): string | null;
-export declare function validateRetention(retention: LoopDraft['retention'] | undefined): string | null;
-/** Full-draft validation for create_loop. */
-export declare function validateLoopDraft(draft: Partial<LoopDraft>): string | null;
-/** Partial validation for update_loop — only the fields present in the patch. */
-export declare function validateLoopPatch(patch: Partial<LoopDraft>): string | null;

package/dist/loop-validation.js

@@ -1,91 +0,0 @@
-import { LOOP_HARNESS_TYPES } from './harness-registry.js';
-import { computeNextRun } from './loop-schedule.js';
-/**
- * Loop payload validation, extracted from index.ts so it is unit-testable
- * without importing the CLI entrypoint (which calls program.parse() on load).
- * Every validator returns an error string, or null when the input is valid.
- */
-/** Derived from the harness registry — the harnesses with validForLoop. */
-export const LOOP_HARNESSES = new Set(LOOP_HARNESS_TYPES);
-/** Validate a loop schedule (interval floor + cron parseability). */
-export function validateSchedule(schedule) {
-    if (!schedule || typeof schedule !== 'object')
-        return 'schedule is required';
-    if (schedule.kind === 'interval') {
-        if (typeof schedule.everyMs !== 'number' || !Number.isFinite(schedule.everyMs) || schedule.everyMs < 1000) {
-            return 'interval everyMs must be a finite number >= 1000';
-        }
-        return null;
-    }
-    if (schedule.kind === 'cron') {
-        if (typeof schedule.expression !== 'string' || !schedule.expression.trim()) {
-            return 'cron expression is required';
-        }
-        try {
-            computeNextRun(schedule, Date.now());
-        }
-        catch {
-            return `Invalid cron expression: ${schedule.expression}`;
-        }
-        return null;
-    }
-    return 'schedule.kind must be "interval" or "cron"';
-}
-export function validateRetention(retention) {
-    const value = retention?.autoClearAfterRuns;
-    const ok = value === null || (typeof value === 'number' && Number.isFinite(value) && value >= 0);
-    return retention && ok ? null : 'retention.autoClearAfterRuns must be null or a non-negative number';
-}
-/** Full-draft validation for create_loop. */
-export function validateLoopDraft(draft) {
-    if (!draft || typeof draft !== 'object')
-        return 'Invalid loop payload';
-    // Required so a create can never slip past the bridge-routing guard and get
-    // duplicated across every connected bridge (create mints a fresh id).
-    if (typeof draft.bridgeId !== 'string' || !draft.bridgeId.trim())
-        return 'bridgeId is required';
-    if (typeof draft.name !== 'string' || !draft.name.trim())
-        return 'Loop name is required';
-    if (typeof draft.task !== 'string' || !draft.task.trim())
-        return 'Loop task is required';
-    if (typeof draft.harness !== 'string' || !LOOP_HARNESSES.has(draft.harness)) {
-        return `Invalid harness: ${String(draft.harness)}`;
-    }
-    if (draft.overlapPolicy !== 'skip' && draft.overlapPolicy !== 'allow') {
-        return 'overlapPolicy must be "skip" or "allow"';
-    }
-    if (typeof draft.enabled !== 'boolean')
-        return 'enabled must be a boolean';
-    const retentionError = validateRetention(draft.retention);
-    if (retentionError)
-        return retentionError;
-    return validateSchedule(draft.schedule);
-}
-/** Partial validation for update_loop — only the fields present in the patch. */
-export function validateLoopPatch(patch) {
-    if (!patch || typeof patch !== 'object')
-        return 'Invalid patch';
-    if ('name' in patch && (typeof patch.name !== 'string' || !patch.name.trim())) {
-        return 'Loop name must be a non-empty string';
-    }
-    if ('task' in patch && (typeof patch.task !== 'string' || !patch.task.trim())) {
-        return 'Loop task must be a non-empty string';
-    }
-    if ('harness' in patch && (typeof patch.harness !== 'string' || !LOOP_HARNESSES.has(patch.harness))) {
-        return `Invalid harness: ${String(patch.harness)}`;
-    }
-    if ('overlapPolicy' in patch && patch.overlapPolicy !== 'skip' && patch.overlapPolicy !== 'allow') {
-        return 'overlapPolicy must be "skip" or "allow"';
-    }
-    if ('enabled' in patch && typeof patch.enabled !== 'boolean')
-        return 'enabled must be a boolean';
-    if ('retention' in patch) {
-        const retentionError = validateRetention(patch.retention);
-        if (retentionError)
-            return retentionError;
-    }
-    if ('schedule' in patch)
-        return validateSchedule(patch.schedule);
-    return null;
-}
-//# sourceMappingURL=loop-validation.js.map

package/dist/loop-validation.js.map

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

package/skills/factory/SKILL.md

@@ -1,198 +0,0 @@
----
-name: factory
-description: deploy and manage a per-project AI software factory (init/up/down/status/teardown) — FTS ticket pipeline + ftown loops. Trigger on "factory init", "deploy a factory", "factory status", "pause the factory".
----
-
-<!-- Vendored from the ffactory repo (skills/factory + factory-template); sync changes there first. -->
-
-# Factory
-
-You are a capable model helping a human deploy and operate a per-project AI software
-factory: a `fticket` (`fts`) ticket pipeline driven by three ftown loops (a dispatcher
-that spawns stage workers, a preflight-guarded interval triage sweep, and a daily digest
-report). This skill is procedures, not narrative — follow the exact commands. It runs
-inside the target project repo (`$REPO` = repo root, resolved via
-`git rev-parse --show-toplevel`).
-
-## Layout
-
-- `factory/` — checked into the project repo, the factory's *definition*:
-  `factory.yaml` (stages, limits, triage config), `skills/*.md` (stage worker briefings +
-  `_protocol.md`), `bin/dispatch.py`.
-- `.ffactory/` — gitignored, the factory's *runtime state*: `factory.db` (fts sqlite),
-  `tickets/<n>/` (per-ticket artifact folders), `worktrees/` (implement-stage checkouts),
-  `dispatch.cursor` (dispatcher bookmark). Disposable — deleting it loses history but not
-  the factory's definition.
-
-## init
-
-Idempotent. If `factory/` already exists in `$REPO`, stop and tell the user the factory is
-already initialized (point them at `status`/`up`/`down` instead) — do not overwrite.
-
-1. **Preconditions.** Confirm `$REPO` is a git repo. Run `~/.ftown/ftown-sessions list` —
-   if it errors, the bridge is down; stop and tell the user to start it first. Confirm
-   `uv` is on PATH.
-2. **Install fticket.** `uv tool install fticket` (or `uv tool upgrade fticket` if already
-   installed). Verify with `fts --help`.
-3. **Resolve routing and copy the template.** If the deployment prompt names the
-   initiating harness/model, use those values. Otherwise, when `FTOWN_SESSION_ID` is
-   set, run `~/.ftown/ftown-sessions get "$FTOWN_SESSION_ID"` and read this session's
-   `shellType` and optional `model`. If neither source identifies the harness, ask the
-   user instead of assuming one.
-   ```bash
-   cp -r ~/.ftown/skills/factory/factory-template "$REPO/factory"
-   ```
-   `factory/bin` moves in as-is (no edits). Set every stage plus `triage` and `digest` to
-   the initiating harness/model. When the initiator has no explicit model, remove each
-   template `model` value so the harness default is used. Only retain or add a different
-   route when the user explicitly requested that override. Also apply the project name
-   (default: the repo directory's basename), operator ftown session id (optional —
-   default `-`, no operator mail), and shared resources (default `staging`,
-   exclusive-only). Edit `factory/factory.yaml` with these values.
-4. **Gitignore + state dirs.** Append `.ffactory/` to `$REPO/.gitignore` (create the file
-   if absent). `mkdir -p "$REPO/.ffactory/tickets"`.
-5. **Init the ticket db**, reading stage order and limits back out of the edited
-   `factory.yaml`:
-   ```bash
-   fts init --db .ffactory/factory.db \
-     --stages groom,design,implement,review,qa,pr \
-     --bounce-limit 3 --claim-ttl-ms 1800000
-   ```
-   (substitute the actual stage names in yaml order, `limits.bounce_limit`, and
-   `limits.claim_ttl_ms`).
-6. **Register shared resources.** For every entry under `resources` in `factory.yaml`,
-   register its stable name and policy. For the default template:
-   ```bash
-   fts register-resource --db .ffactory/factory.db \
-     --name staging --policy exclusive_only
-   ```
-   Repeat once per configured resource. Workers acquire these leases FIFO; do not invent
-   resource names at runtime that were not declared in the factory definition.
-7. **Register the loops, grouped under one factory label.** The `--group` flag folds all
-   loops together in the ftown dashboard and requires ftown bridge PR #29. If
-   `loop create` rejects `--group` as an unknown flag, tell the user their bridge is out
-   of date and needs updating — do not silently drop the flag and register ungrouped.
-
-   Dispatcher (interval loop, runs the Python dispatcher every tick):
-   ```bash
-   ~/.ftown/ftown-sessions loop create \
-     --name "<project>-dispatch" --every 30s --shell shell --workdir "$REPO" \
-     --group "Factory: <project>" --max-runtime 10m --retention 10 \
-     --preflight "~/.local/bin/fts queues --db $REPO/.ffactory/factory.db --json | python3 -c 'import json,sys; qs=json.load(sys.stdin); sys.exit(0 if any(q.get(\"queued\",0)+q.get(\"claimed\",0)+q.get(\"in_progress\",0)+q.get(\"blocked\",0) for q in qs) else 1)'" \
-     --task "uv run --python 3.13 --with fticket,pyyaml python factory/bin/dispatch.py"
-   ```
-   (`--every` from `limits.dispatch_every`. The preflight skips the tick — no shell
-   session — while no ticket is queued/claimed/in_progress/blocked, so an idle factory
-   costs nothing. A resting `rejected`/`dead_letter` ticket doesn't wake it: those belong
-   to explicit chaining and triage respectively.)
-
-   Triage (interval loop with a preflight skip guard — only spawns a session when there
-   is dead-letter/orphan work; requires ftown bridge >= 0.18.0 for cheap preflight skips —
-   on 0.17 the preflight still works but bloats run history since a skip still logs a
-   run):
-   ```bash
-   ~/.ftown/ftown-sessions loop create \
-     --name "<project>-triage" --every 10m --shell claude --model sonnet \
-     --workdir "$REPO" --group "Factory: <project>" --retention 10 \
-     --preflight "~/.local/bin/fts triage --db $REPO/.ffactory/factory.db --json | python3 -c 'import json,sys; d=json.load(sys.stdin); sys.exit(0 if d[\"dead_letter\"] or d[\"orphans\"] else 1)'" \
-     --task "FTS_DB=<abs path to .ffactory/factory.db> REPO_ROOT=<abs $REPO> OPERATOR_SESSION=<value or -> — Read and follow factory/skills/triage.md."
-   ```
-   (`--every`/`--shell`/`--model` from `triage.every`/`triage.harness`/`triage.model`.)
-   The preflight exits 0 (work exists → run the session) when `fts triage --json` reports
-   any dead_letter or orphan tickets, and exits 1 (healthy → skip, no session spawned)
-   otherwise. The triage briefing must set the three task variables literally;
-   `triage.md` treats a missing variable as fatal.
-
-   Digest (daily cron loop, shift report mailed to the operator) — register this loop
-   ONLY when `operator_session` in `factory.yaml` is not `-`; skip it entirely otherwise,
-   since there is nowhere to mail the digest:
-   ```bash
-   ~/.ftown/ftown-sessions loop create \
-     --name "<project>-digest" --cron "0 9 * * *" --shell claude --model sonnet \
-     --workdir "$REPO" --group "Factory: <project>" --retention 5 \
-     --task "FTS_DB=<abs path to .ffactory/factory.db> REPO_ROOT=<abs $REPO> OPERATOR_SESSION=<operator> — Read and follow factory/skills/digest.md."
-   ```
-   (`--cron`/`--shell`/`--model` from `digest.cron`/`digest.harness`/`digest.model`.)
-8. **Wrap up.** Suggest the user commit `factory/` (not `.ffactory/`). Show them how to
-   create the first ticket:
-   ```bash
-   mkdir -p .ffactory/tickets/1
-   # write .ffactory/tickets/1/request.md with the ask
-   fts create --db .ffactory/factory.db --title "<title>" --stage groom \
-     --folder .ffactory/tickets/1
-   ```
-   and how to watch it: `fts serve --db .ffactory/factory.db --port 8377` (dashboard).
-
-## resource leases for an existing factory
-
-Existing factories are never overwritten by `factory init`. To introduce a new shared
-resource safely, add its stable name/policy under `resources` in `factory/factory.yaml`,
-then register it idempotently in the existing database:
-
-```bash
-fts register-resource --db .ffactory/factory.db \
-  --name staging --policy exclusive_only
-fts resources --db .ffactory/factory.db --json
-```
-
-Do not rename a resource while leases/waiters exist; register the new name, migrate users,
-then retire the old name only after `fts resources` shows it idle.
-
-## up / down
-
-Resume or pause every registered loop by name. Loops don't expose lookup-by-name
-directly, so filter `loops` output for the project's `--group` label (`Factory:
-<project>`) to get ids first — this naturally covers whichever loops are actually
-registered (dispatch + triage always; digest only if an operator is configured):
-
-```bash
-~/.ftown/ftown-sessions loops                      # find ids for all loops in group "Factory: <project>"
-~/.ftown/ftown-sessions loop resume <loop-id>      # up — repeat for each loop id found
-~/.ftown/ftown-sessions loop pause  <loop-id>      # down — repeat for each loop id found
-```
-
-## status
-
-Report all of:
-
-1. `fts board --db .ffactory/factory.db` — ticket counts by stage.
-2. `fts queues --db .ffactory/factory.db` — per-stage claim queues.
-3. `fts resources --db .ffactory/factory.db` — active leases and FIFO waitlists.
-4. `fts doctor --db .ffactory/factory.db` — health checks (flag any failure first).
-5. `~/.ftown/ftown-sessions loop runs <loop-id>` for every loop id registered under
-   `Factory: <project>` (dispatch, triage, and digest if present) — last few runs of
-   each, success/error. For triage specifically, also check `loop get <triage-id>` for
-   `lastSkipAt`/`lastSkipReason` — frequent skips are healthy (the preflight guard found
-   no dead-letter/orphan work).
-6. Active workers: `~/.ftown/ftown-sessions list` filtered to names starting with
-   `<project>-t` (worker sessions the dispatcher spawned, distinct from the loop names
-   themselves which start with `<project>-dispatch`/`<project>-triage`/`<project>-digest`).
-
-## run-now
-
-Force an immediate dispatcher tick without waiting for the interval:
-```bash
-~/.ftown/ftown-sessions loop run <dispatch-loop-id>
-```
-
-## teardown
-
-Confirm with the user first — this is destructive to scheduling, distinct from deleting
-data.
-
-1. Pause then delete every loop registered under `Factory: <project>`: `loop pause <id>`
-   then `loop delete <id>` for dispatch, triage, and digest (if it was registered).
-2. Remind the user: `.ffactory/` is disposable runtime state (db, tickets, worktrees) —
-   only delete it if they explicitly confirm, since it's the ticket history. `factory/`
-   is the checked-in definition — keep it (removing it is a separate, deliberate repo
-   change, not part of teardown).
-
-## Troubleshooting
-
-| Symptom | Cause / fix |
-| --- | --- |
-| `ftown-sessions list` errors at any step | Bridge is down — start the ftown bridge before retrying. |
-| `loop create --group` rejected as unknown flag | Bridge predates ftown PR #29 — tell the user to update the bridge; do not drop `--group` and register loops ungrouped. |
-| Workers never spawn even though tickets are queued | Check `loop runs <dispatch-id>` for run status first, then the dispatcher's own stderr (surfaced in the run's session output) for `dispatch.py` errors — e.g. `max_sessions` cap reached, or a claim that keeps expiring. |
-| A ticket looks stuck in one stage | `fts why --db .ffactory/factory.db <id>` — gives a stuck diagnosis (expired claim, bounce-limit hit, missing resource lease, etc.) without needing to read the raw db. |
-| Triage never fires | Check `loop get <triage-id>` for `lastSkipAt`/`lastSkipReason` — preflight guard skipping is healthy when there are no dead-letter/orphan tickets; only worry if `fts triage --json` shows work but the loop still skips. |