@gr8ful/spf 0.14.0 → 0.16.0

package/dist/core/data_types.d.ts

@@ -671,7 +671,7 @@ export interface SandboxSpec {
 }
 export declare const AgentConfigSchema: v.ObjectSchema<{
     readonly name: v.StringSchema<undefined>;
-    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
     readonly model: v.OptionalSchema<v.StringSchema<undefined>, "google/gemini-3.6-flash">;
     readonly thinking: v.OptionalSchema<v.PicklistSchema<["off", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, "medium">;
     readonly color: v.OptionalSchema<v.StringSchema<undefined>, "">;
@@ -688,7 +688,7 @@ export declare const AgentConfigSchema: v.ObjectSchema<{
 }, undefined>;
 export type AgentConfig = v.InferOutput<typeof AgentConfigSchema>;
 export declare const ConfigDefaultsSchema: v.ObjectSchema<{
-    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
     readonly model: v.OptionalSchema<v.StringSchema<undefined>, "google/gemini-3.6-flash">;
     readonly thinking: v.OptionalSchema<v.PicklistSchema<["off", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, "medium">;
     readonly color: v.OptionalSchema<v.StringSchema<undefined>, "">;
@@ -763,8 +763,106 @@ export declare const OTelConfigSchema: v.ObjectSchema<{
     readonly service_name: v.OptionalSchema<v.StringSchema<undefined>, "spf">;
 }, undefined>;
 export type OTelConfig = v.InferOutput<typeof OTelConfigSchema>;
+/**
+ * MIGRATION NOTE (BT-issue #66, 3 PRs): `observability.db` used to be ONLY a
+ * bare string (a local sqlite path, defaulting to ".spf/data/spf.db"). This
+ * is now a discriminated shape that additionally accepts an explicit
+ * `{ kind: "sqlite", path? }` object (equivalent to the string form, just
+ * spelled out) and a `{ kind: "d1", database_id, ... }` object that names a
+ * remote Cloudflare D1 database instead of a local file. The bare-string
+ * form is unchanged and remains the default for every existing config —
+ * nothing in the wild needs to change. `resolveObservabilityDb` below
+ * normalizes all three accepted forms to one shape.
+ *
+ * PR 1 (this schema + normalizer + `paths.resolveDataPaths` plumbing) left
+ * `resolveDataPaths` refusing a `kind: "d1"` config outright — no adapter
+ * existed yet. PR 2 (`core/trace_db.ts`'s `TraceDb` interface, `LocalTraceDb`,
+ * `D1TraceDb`, and `createTraceDb()`, wired through `Tracer`/`SfDb`) removes
+ * that refusal: `resolveDataPaths` now returns a usable descriptor for
+ * either kind, and both backends are real. PR 3 wires `spf doctor`/`spf
+ * init`'s interview flow to the new option.
+ */
+export declare const SqliteDbConfigSchema: v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"sqlite", undefined>;
+    readonly path: v.OptionalSchema<v.StringSchema<undefined>, ".spf/data/spf.db">;
+}, undefined>;
+export type SqliteDbConfig = v.InferOutput<typeof SqliteDbConfigSchema>;
+/**
+ * `account_id_env`/`api_token_env` default to the SAME env var names
+ * `core/cloudflare_provider.ts` already reads for the Cloudflare Workers AI
+ * provider (`CLOUDFLARE_ACCOUNT_ID`/`CLOUDFLARE_API_TOKEN`, see
+ * `core/providers.ts`'s `PROVIDER_ENV_KEYS.cloudflare`) — one Cloudflare
+ * account's credentials, read from the same two env vars, cover both
+ * Workers AI and a D1-backed trace db unless a config explicitly points
+ * elsewhere (e.g. a second Cloudflare account) by naming different env vars.
+ */
+export declare const D1DbConfigSchema: v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"d1", undefined>;
+    readonly database_id: v.StringSchema<undefined>;
+    readonly account_id_env: v.OptionalSchema<v.StringSchema<undefined>, "CLOUDFLARE_ACCOUNT_ID">;
+    readonly api_token_env: v.OptionalSchema<v.StringSchema<undefined>, "CLOUDFLARE_API_TOKEN">;
+}, undefined>;
+export type D1DbConfig = v.InferOutput<typeof D1DbConfigSchema>;
+export declare const ObservabilityDbSchema: v.SchemaWithPipe<readonly [v.UnknownSchema, v.RawTransformAction<unknown, string | {
+    kind: "sqlite";
+    path: string;
+} | {
+    kind: "d1";
+    database_id: string;
+    account_id_env: string;
+    api_token_env: string;
+}>]>;
+export type ObservabilityDbConfig = v.InferOutput<typeof ObservabilityDbSchema>;
+/**
+ * What `resolveObservabilityDb` ACCEPTS — deliberately more permissive than
+ * `ObservabilityDbConfig` (that type is the schema's OUTPUT, post-default,
+ * so every optional field reads as required). This is the pre-default INPUT
+ * shape — `path`/`account_id_env`/`api_token_env` all optional, exactly
+ * what a hand-written `{kind:"sqlite"}` or `{kind:"d1", database_id:"..."}`
+ * literal looks like before `v.parse` fills its defaults in. An already-
+ * parsed `ObservabilityDbConfig` (every optional field present) satisfies
+ * this too, so the one normalizer works on config fresh off `v.parse` AND
+ * on a literal built by hand (e.g. in a test, or by a future caller that
+ * hasn't gone through the schema).
+ */
+export type ObservabilityDbInput = string | {
+    kind: "sqlite";
+    path?: string;
+} | {
+    kind: "d1";
+    database_id: string;
+    account_id_env?: string;
+    api_token_env?: string;
+};
+/** What `resolveObservabilityDb` normalizes any of the three accepted `db:` forms to. PR 2's D1 adapter is built against this shape. */
+export type NormalizedObservabilityDb = {
+    kind: "sqlite";
+    path: string;
+} | {
+    kind: "d1";
+    database_id: string;
+    account_id_env: string;
+    api_token_env: string;
+};
+/**
+ * Normalizes `observability.db` — bare string, `{kind:"sqlite",...}`, or
+ * `{kind:"d1",...}` — to one shape. Pure and side-effect-free: does NOT
+ * resolve `path` to an absolute path (that's `paths.resolveDataPaths`'s job,
+ * which needs `repo_root` to do it) and does NOT read the D1 env vars it
+ * names (that's PR 2's adapter's job, at the point it actually needs to
+ * authenticate).
+ */
+export declare function resolveObservabilityDb(db: ObservabilityDbInput): NormalizedObservabilityDb;
 export declare const ObservabilityConfigSchema: v.ObjectSchema<{
-    readonly db: v.OptionalSchema<v.StringSchema<undefined>, ".spf/data/spf.db">;
+    readonly db: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.RawTransformAction<unknown, string | {
+        kind: "sqlite";
+        path: string;
+    } | {
+        kind: "d1";
+        database_id: string;
+        account_id_env: string;
+        api_token_env: string;
+    }>]>, ".spf/data/spf.db">;
     readonly poll_ms: v.OptionalSchema<v.NumberSchema<undefined>, 500>;
     readonly otel: v.OptionalSchema<v.ObjectSchema<{
         readonly endpoint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>]>;
@@ -839,14 +937,43 @@ export declare const JiraIssueTypeMapSchema: v.ObjectSchema<{
     readonly spec: v.OptionalSchema<v.StringSchema<undefined>, "Story">;
 }, undefined>;
 export type JiraIssueTypeMap = v.InferOutput<typeof JiraIssueTypeMapSchema>;
+/**
+ * Optional, per-project `WatchState` -> Jira workflow-status-name map.
+ * Unlike `JiraIssueTypeMapSchema`, this has no sane universal default:
+ * "To Do" vs "Open" vs "Backlog" (and everything in between) is entirely
+ * per-project workflow configuration in Jira, so every field defaults to
+ * unset. A `WatchState` with no entry here keeps today's behavior exactly —
+ * `jira_provider.ts`'s `transition()`/`claim()` update the label only and
+ * never attempt a status change for it.
+ *
+ * Deliberately covers only the states a human's Jira board status would
+ * plausibly want to reflect (the build lane, `spec-ready` through
+ * `blocked`) — the refine-lane states (`refining`, `split-proposed`, ...)
+ * are internal bookkeeping for `core/refine.ts`, not board-visible work.
+ *
+ * `jira_provider.ts`'s `syncStatus()` is the reader; `validateStatusMap()`
+ * is what `spf watch init` and `spf watch`'s own startup check should call
+ * to confirm each configured name is a real status on the project before an
+ * unattended run relies on it — same shape as `issue_types`/
+ * `validateIssueTypes()`.
+ */
+export declare const JiraStatusMapSchema: v.ObjectSchema<{
+    readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type JiraStatusMap = v.InferOutput<typeof JiraStatusMapSchema>;
 /**
  * Only consulted when `issue_provider: jira`. Auth is `JIRA_EMAIL` +
  * `JIRA_API_TOKEN` env vars, checked at startup like `GITHUB_TOKEN`. Whole-
  * object replace on config-file-layer merge, like `refine`/
  * `observability.otel` (see `agents.ts`'s `mergeRawConfig`) — an override
- * file that touches `watch.jira` at all must repeat `issue_types` too if it
- * wants to keep a customized mapping, same caveat that already applies to
- * `base_url`/`project_key` today.
+ * file that touches `watch.jira` at all must repeat `issue_types`/
+ * `status_map` too if it wants to keep a customized mapping, same caveat
+ * that already applies to `base_url`/`project_key` today.
  */
 export declare const WatchJiraConfigSchema: v.ObjectSchema<{
     readonly base_url: v.OptionalSchema<v.StringSchema<undefined>, "">;
@@ -873,8 +1000,85 @@ export declare const WatchJiraConfigSchema: v.ObjectSchema<{
         task: string;
         spec: string;
     }>;
+    readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+        readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, () => {
+        "spec-ready"?: string | undefined;
+        ready?: string | undefined;
+        working?: string | undefined;
+        review?: string | undefined;
+        done?: string | undefined;
+        blocked?: string | undefined;
+    }>;
 }, undefined>;
 export type WatchJiraConfig = v.InferOutput<typeof WatchJiraConfigSchema>;
+/**
+ * Optional, per-repo `WatchState` -> GitHub Projects v2 "Status" option-name
+ * map — the GitHub-side twin of `JiraIssueTypeMap`'s sibling on the Jira
+ * provider (see `jira_provider.ts`'s `status_map`). No sane universal
+ * default: a board's Status column options ("Todo"/"In Progress"/"Done", or
+ * anything else) are per-project configuration, so every field defaults to
+ * unset. A `WatchState` with no entry keeps today's behavior exactly —
+ * `github_provider.ts`'s `transition()`/`claim()` update the label only and
+ * never touch Projects v2 for it.
+ *
+ * Same six build-lane states as Jira's map — the refine-lane's own
+ * bookkeeping states (`refining`, `split-proposed`, ...) aren't board-visible
+ * work, same reasoning as `jira_provider.ts`'s `JiraStatusMapSchema`.
+ *
+ * `github_provider.ts`'s `syncStatus()` is the reader; `validateStatusMap()`
+ * is what `spf watch init` and `spf watch`'s own startup check call to
+ * confirm each configured name is a real Status option on the configured
+ * project before an unattended run relies on it.
+ */
+export declare const GithubStatusMapSchema: v.ObjectSchema<{
+    readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type GithubStatusMap = v.InferOutput<typeof GithubStatusMapSchema>;
+/**
+ * Only consulted when `issue_provider: github` (or `code_host: github`) AND
+ * `status_map` actually has an entry configured — `project_number: 0` (the
+ * default) disables status sync outright regardless of `status_map`, since
+ * there's no sane "guess the board" default: a repo can have zero, one, or
+ * many Projects v2 boards, and none of them is canonical. Scoped to the
+ * repo's OWNER (`watch.repo`'s "owner/name", the owner half) — GitHub
+ * Projects v2 numbers are per-owner, not per-repo, so `project_number: 3`
+ * means owner's project #3, which may or may not have this repo's issues on
+ * it yet (`github_provider.ts`'s `syncStatus()` adds the issue to the
+ * project itself the first time it needs to). Whole-object replace on
+ * config-file-layer merge, like `jira`/`refine` above — an override file
+ * that touches `watch.github` at all must repeat `status_map` too if it
+ * wants to keep a customized mapping.
+ */
+export declare const WatchGithubConfigSchema: v.ObjectSchema<{
+    readonly project_number: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 0>;
+    readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+        readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, () => {
+        "spec-ready"?: string | undefined;
+        ready?: string | undefined;
+        working?: string | undefined;
+        review?: string | undefined;
+        done?: string | undefined;
+        blocked?: string | undefined;
+    }>;
+}, undefined>;
+export type WatchGithubConfig = v.InferOutput<typeof WatchGithubConfigSchema>;
 /**
  * The second `spf watch` lane: decompose a `<prefix>:spec-ready` product
  * spec into a feature/story tree of real issues, instead of running
@@ -1024,6 +1228,21 @@ export declare const WatchConfigSchema: v.ObjectSchema<{
             task: string;
             spec: string;
         }>;
+        readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+            readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, () => {
+            "spec-ready"?: string | undefined;
+            ready?: string | undefined;
+            working?: string | undefined;
+            review?: string | undefined;
+            done?: string | undefined;
+            blocked?: string | undefined;
+        }>;
     }, undefined>, () => {
         base_url: string;
         project_key: string;
@@ -1035,6 +1254,42 @@ export declare const WatchConfigSchema: v.ObjectSchema<{
             task: string;
             spec: string;
         };
+        status_map: {
+            "spec-ready"?: string | undefined;
+            ready?: string | undefined;
+            working?: string | undefined;
+            review?: string | undefined;
+            done?: string | undefined;
+            blocked?: string | undefined;
+        };
+    }>;
+    readonly github: v.OptionalSchema<v.ObjectSchema<{
+        readonly project_number: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 0>;
+        readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+            readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, () => {
+            "spec-ready"?: string | undefined;
+            ready?: string | undefined;
+            working?: string | undefined;
+            review?: string | undefined;
+            done?: string | undefined;
+            blocked?: string | undefined;
+        }>;
+    }, undefined>, () => {
+        project_number: number;
+        status_map: {
+            "spec-ready"?: string | undefined;
+            ready?: string | undefined;
+            working?: string | undefined;
+            review?: string | undefined;
+            done?: string | undefined;
+            blocked?: string | undefined;
+        };
     }>;
     readonly refine: v.OptionalSchema<v.ObjectSchema<{
         readonly enabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
@@ -1147,7 +1402,7 @@ export type ReviewConfig = v.InferOutput<typeof ReviewConfigSchema>;
  */
 export declare const TierSchema: v.ObjectSchema<{
     readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+    readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
     readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
 }, undefined>;
 export type Tier = v.InferOutput<typeof TierSchema>;
@@ -1182,7 +1437,7 @@ export declare const TieringConfigSchema: v.ObjectSchema<{
     readonly enabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     readonly tiers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
         readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
         readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
     }, undefined>, undefined>, () => never[]>;
     readonly roles: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, () => {}>;
@@ -1191,7 +1446,7 @@ export type TieringConfig = v.InferOutput<typeof TieringConfigSchema>;
 export declare const SFConfigSchema: v.ObjectSchema<{
     readonly env: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, () => {}>;
     readonly defaults: v.OptionalSchema<v.ObjectSchema<{
-        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
         readonly model: v.OptionalSchema<v.StringSchema<undefined>, "google/gemini-3.6-flash">;
         readonly thinking: v.OptionalSchema<v.PicklistSchema<["off", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, "medium">;
         readonly color: v.OptionalSchema<v.StringSchema<undefined>, "">;
@@ -1244,7 +1499,7 @@ export declare const SFConfigSchema: v.ObjectSchema<{
         readonly max_run_cost: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.GtValueAction<number, 0, undefined>]>, undefined>;
         readonly max_run_tokens: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.GtValueAction<number, 0, undefined>]>, undefined>;
     }, undefined>, () => {
-        coding_agent: "claude_code" | "flue";
+        coding_agent: "claude_code" | "flue" | "opencode";
         model: string;
         thinking: "high" | "low" | "max" | "medium" | "minimal" | "off" | "xhigh";
         color: string;
@@ -1256,7 +1511,15 @@ export declare const SFConfigSchema: v.ObjectSchema<{
         max_run_tokens?: number | undefined;
     }>;
     readonly observability: v.OptionalSchema<v.ObjectSchema<{
-        readonly db: v.OptionalSchema<v.StringSchema<undefined>, ".spf/data/spf.db">;
+        readonly db: v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnknownSchema, v.RawTransformAction<unknown, string | {
+            kind: "sqlite";
+            path: string;
+        } | {
+            kind: "d1";
+            database_id: string;
+            account_id_env: string;
+            api_token_env: string;
+        }>]>, ".spf/data/spf.db">;
         readonly poll_ms: v.OptionalSchema<v.NumberSchema<undefined>, 500>;
         readonly otel: v.OptionalSchema<v.ObjectSchema<{
             readonly endpoint: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.UrlAction<string, undefined>]>;
@@ -1264,7 +1527,15 @@ export declare const SFConfigSchema: v.ObjectSchema<{
             readonly service_name: v.OptionalSchema<v.StringSchema<undefined>, "spf">;
         }, undefined>, undefined>;
     }, undefined>, () => {
-        db: string;
+        db: string | {
+            kind: "sqlite";
+            path: string;
+        } | {
+            kind: "d1";
+            database_id: string;
+            account_id_env: string;
+            api_token_env: string;
+        };
         poll_ms: number;
         otel?: {
             endpoint: string;
@@ -1276,7 +1547,7 @@ export declare const SFConfigSchema: v.ObjectSchema<{
     }>;
     readonly agents: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
         readonly name: v.StringSchema<undefined>;
-        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+        readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
         readonly model: v.OptionalSchema<v.StringSchema<undefined>, "google/gemini-3.6-flash">;
         readonly thinking: v.OptionalSchema<v.PicklistSchema<["off", "minimal", "low", "medium", "high", "xhigh", "max"], undefined>, "medium">;
         readonly color: v.OptionalSchema<v.StringSchema<undefined>, "">;
@@ -1363,6 +1634,21 @@ export declare const SFConfigSchema: v.ObjectSchema<{
                 task: string;
                 spec: string;
             }>;
+            readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+                readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, () => {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            }>;
         }, undefined>, () => {
             base_url: string;
             project_key: string;
@@ -1374,6 +1660,42 @@ export declare const SFConfigSchema: v.ObjectSchema<{
                 task: string;
                 spec: string;
             };
+            status_map: {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            };
+        }>;
+        readonly github: v.OptionalSchema<v.ObjectSchema<{
+            readonly project_number: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, 0>;
+            readonly status_map: v.OptionalSchema<v.ObjectSchema<{
+                readonly "spec-ready": v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly ready: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly working: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly review: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly done: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly blocked: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, () => {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            }>;
+        }, undefined>, () => {
+            project_number: number;
+            status_map: {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            };
         }>;
         readonly refine: v.OptionalSchema<v.ObjectSchema<{
             readonly enabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
@@ -1421,6 +1743,25 @@ export declare const SFConfigSchema: v.ObjectSchema<{
                 task: string;
                 spec: string;
             };
+            status_map: {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            };
+        };
+        github: {
+            project_number: number;
+            status_map: {
+                "spec-ready"?: string | undefined;
+                ready?: string | undefined;
+                working?: string | undefined;
+                review?: string | undefined;
+                done?: string | undefined;
+                blocked?: string | undefined;
+            };
         };
         refine: {
             enabled: boolean;
@@ -1467,7 +1808,7 @@ export declare const SFConfigSchema: v.ObjectSchema<{
         readonly enabled: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
         readonly tiers: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
             readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
-            readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code"], undefined>, "flue">;
+            readonly coding_agent: v.OptionalSchema<v.PicklistSchema<["flue", "claude_code", "opencode"], undefined>, "flue">;
             readonly model: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
         }, undefined>, undefined>, () => never[]>;
         readonly roles: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, () => {}>;
@@ -1475,7 +1816,7 @@ export declare const SFConfigSchema: v.ObjectSchema<{
         enabled: boolean;
         tiers: {
             name: string;
-            coding_agent: "claude_code" | "flue";
+            coding_agent: "claude_code" | "flue" | "opencode";
             model: string;
         }[];
         roles: {