@marktiderman/genesis-features 0.1.2 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +56 -1
- package/dist/blocks.d.ts +235 -0
- package/dist/blocks.js +4 -0
- package/dist/blocks.js.map +1 -0
- package/dist/chunk-2ARZER3G.js +55 -0
- package/dist/chunk-2ARZER3G.js.map +1 -0
- package/dist/chunk-EF72JS5S.js +155 -0
- package/dist/chunk-EF72JS5S.js.map +1 -0
- package/dist/{chunk-ZYWK7XPT.js → chunk-KCUQY5UZ.js} +76 -15
- package/dist/chunk-KCUQY5UZ.js.map +1 -0
- package/dist/index.d.ts +43 -3
- package/dist/index.js +3 -1
- package/dist/{model-CW5ocPFw.d.ts → model-CW3d2gsf.d.ts} +117 -5
- package/dist/node.d.ts +4 -3
- package/dist/node.js +5 -4
- package/dist/node.js.map +1 -1
- package/dist/platforms-NR0liM8L.d.ts +10 -0
- package/dist/react.d.ts +3 -2
- package/dist/react.js +7 -4
- package/dist/react.js.map +1 -1
- package/package.json +10 -6
- package/dist/chunk-ZYWK7XPT.js.map +0 -1
|
@@ -1,8 +1,9 @@
|
|
|
1
|
+
import { FEATURE_PLATFORMS, requirementProblem, cycleProblems } from './chunk-2ARZER3G.js';
|
|
1
2
|
import { z } from 'zod';
|
|
2
3
|
|
|
3
|
-
|
|
4
|
-
var FEATURE_STATUSES = ["planned", "building", "beta", "live", "deprecated", "retired"];
|
|
4
|
+
var FEATURE_STATUSES = ["idea", "planned", "building", "beta", "live", "deprecated", "retired"];
|
|
5
5
|
var FEATURE_HORIZONS = ["now", "next", "later"];
|
|
6
|
+
var FEATURE_LAYERS = ["token", "primitive", "pattern", "layout", "hook", "provider", "block", "service", "tool"];
|
|
6
7
|
var FLAG_KINDS = ["release", "experiment", "ops", "permission"];
|
|
7
8
|
var ID = /^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*$/;
|
|
8
9
|
var DAY = /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/;
|
|
@@ -25,6 +26,7 @@ var visibilitySchema = z.union([
|
|
|
25
26
|
z.enum(["internal", "customer", "public"]),
|
|
26
27
|
z.string().regex(/^client:\S+$/, "must be internal, customer, public or client:<name>")
|
|
27
28
|
]);
|
|
29
|
+
var perPlatform = (value) => z.object(Object.fromEntries(FEATURE_PLATFORMS.map((p) => [p, value.optional()]))).strict();
|
|
28
30
|
var featureSchema = z.object({
|
|
29
31
|
name: text,
|
|
30
32
|
summary: text,
|
|
@@ -44,7 +46,15 @@ var featureSchema = z.object({
|
|
|
44
46
|
tagline: text.optional(),
|
|
45
47
|
category: text.optional(),
|
|
46
48
|
media: z.object({ image: pathOrUrl.optional(), video: pathOrUrl.optional(), alt: text }).strict().optional(),
|
|
47
|
-
highlight: z.boolean().optional()
|
|
49
|
+
highlight: z.boolean().optional(),
|
|
50
|
+
layer: z.enum(FEATURE_LAYERS).optional(),
|
|
51
|
+
platforms: perPlatform(z.enum(FEATURE_STATUSES)).optional(),
|
|
52
|
+
entry: perPlatform(text).optional(),
|
|
53
|
+
keywords: z.array(text).optional(),
|
|
54
|
+
extends: z.string().regex(ID, "must be a feature id").optional(),
|
|
55
|
+
requires: z.array(z.string().regex(ID, "must be a feature id")).optional(),
|
|
56
|
+
contributes: z.array(text).optional(),
|
|
57
|
+
slots: z.array(text).optional()
|
|
48
58
|
}).strict();
|
|
49
59
|
var flagValue = z.union([z.boolean(), z.string(), z.number(), z.record(z.string(), z.unknown())]);
|
|
50
60
|
var flagSchema = z.object({
|
|
@@ -84,12 +94,14 @@ function featureProblems(id, def) {
|
|
|
84
94
|
}
|
|
85
95
|
function defineFeatures(features) {
|
|
86
96
|
const problems = [];
|
|
97
|
+
const invalid = /* @__PURE__ */ new Set();
|
|
87
98
|
const owners = /* @__PURE__ */ new Map();
|
|
88
99
|
for (const [id, def] of Object.entries(features)) {
|
|
89
100
|
if (!ID.test(id)) problems.push(`${id}: the id must be lowercase letters and digits, joined by -, _ or .`);
|
|
90
101
|
const parsed = featureSchema.safeParse(def);
|
|
91
102
|
if (!parsed.success) {
|
|
92
103
|
problems.push(...issues(id, parsed.error));
|
|
104
|
+
invalid.add(id);
|
|
93
105
|
continue;
|
|
94
106
|
}
|
|
95
107
|
problems.push(...featureProblems(id, def));
|
|
@@ -99,9 +111,31 @@ function defineFeatures(features) {
|
|
|
99
111
|
else owners.set(name, id);
|
|
100
112
|
}
|
|
101
113
|
}
|
|
114
|
+
problems.push(...relationProblems(features, invalid));
|
|
102
115
|
if (problems.length) throw new FeatureRegistryError(problems);
|
|
103
116
|
return Object.freeze(features);
|
|
104
117
|
}
|
|
118
|
+
var UNSHIPPED = ["idea", "planned", "retired"];
|
|
119
|
+
function relationProblems(features, skip) {
|
|
120
|
+
const problems = [];
|
|
121
|
+
const has = (id) => Object.hasOwn(features, id);
|
|
122
|
+
for (const [id, def] of Object.entries(features)) {
|
|
123
|
+
if (skip.has(id)) continue;
|
|
124
|
+
if (def.extends !== void 0) {
|
|
125
|
+
if (def.extends === id) problems.push(`${id}.extends: a feature can't extend itself`);
|
|
126
|
+
else if (!has(def.extends)) problems.push(`${id}.extends: "${def.extends}" is not a feature`);
|
|
127
|
+
}
|
|
128
|
+
for (const req of def.requires ?? []) {
|
|
129
|
+
const problem = requirementProblem(features, id, req, { noun: "feature" });
|
|
130
|
+
if (problem) problems.push(problem);
|
|
131
|
+
else if (!skip.has(req) && (def.status === "beta" || def.status === "live") && UNSHIPPED.includes(features[req].status)) {
|
|
132
|
+
problems.push(`${id}.requires: a ${def.status} feature can't require "${req}", which is ${features[req].status}`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
problems.push(...cycleProblems(features, skip));
|
|
137
|
+
return problems;
|
|
138
|
+
}
|
|
105
139
|
function defineFlags(features, flags) {
|
|
106
140
|
const problems = [];
|
|
107
141
|
const seen = /* @__PURE__ */ new Map();
|
|
@@ -142,17 +176,35 @@ function toRecords(features, flags) {
|
|
|
142
176
|
flags: flagsForFeature(flags, id)
|
|
143
177
|
}));
|
|
144
178
|
}
|
|
145
|
-
function
|
|
179
|
+
function statusOn(def, platform) {
|
|
180
|
+
if (def.platforms) return def.platforms[platform];
|
|
181
|
+
const apps = def.apps.map((a) => a === "node" ? "server" : a);
|
|
182
|
+
return apps.includes(platform) ? def.status : void 0;
|
|
183
|
+
}
|
|
184
|
+
function findFeatures(features, term, flags, options = {}) {
|
|
146
185
|
const needle = term.trim().toLowerCase();
|
|
147
|
-
|
|
186
|
+
const filtered = Boolean(options.platform || options.layer || options.status);
|
|
187
|
+
if (!needle && !filtered) return [];
|
|
188
|
+
const keep = (r) => (!options.platform || statusOn(r, options.platform) !== void 0) && (!options.layer || r.layer === options.layer) && (!options.status || r.status === options.status);
|
|
148
189
|
const score = (r) => {
|
|
190
|
+
if (!needle) return 0;
|
|
149
191
|
if (r.id === needle || r.aliases?.includes(needle)) return 0;
|
|
150
192
|
if (r.id.includes(needle) || r.name.toLowerCase().includes(needle)) return 1;
|
|
193
|
+
if (r.keywords?.some((k) => k.toLowerCase().includes(needle))) return 1;
|
|
151
194
|
if (r.flags.some((f) => f.toLowerCase().includes(needle))) return 2;
|
|
152
|
-
const rest = [
|
|
195
|
+
const rest = [
|
|
196
|
+
r.summary,
|
|
197
|
+
r.tagline,
|
|
198
|
+
r.category,
|
|
199
|
+
...r.links?.code ?? [],
|
|
200
|
+
...r.aliases ?? [],
|
|
201
|
+
...Object.values(r.entry ?? {}),
|
|
202
|
+
...r.slots ?? [],
|
|
203
|
+
...r.contributes ?? []
|
|
204
|
+
];
|
|
153
205
|
return rest.some((v) => v?.toLowerCase().includes(needle)) ? 3 : -1;
|
|
154
206
|
};
|
|
155
|
-
return toRecords(features, flags).map((r) => [score(r), r]).filter(([s]) => s >= 0).sort((a, b) => a[0] - b[0]).map(([, r]) => r);
|
|
207
|
+
return toRecords(features, flags).filter(keep).map((r) => [score(r), r]).filter(([s]) => s >= 0).sort((a, b) => a[0] - b[0]).map(([, r]) => r);
|
|
156
208
|
}
|
|
157
209
|
|
|
158
210
|
// src/generate.ts
|
|
@@ -278,13 +330,18 @@ description: Find, add, change and retire this repo's features in ${source}, and
|
|
|
278
330
|
\`${source}\` is the one list of what this product does. Running code imports it, and
|
|
279
331
|
\`${command} build\` generates the rest from it: ${outputs.join(", ")}.
|
|
280
332
|
|
|
281
|
-
## Find
|
|
282
|
-
- \`${command} find <term>\` searches ids, aliases, names, summaries
|
|
283
|
-
|
|
333
|
+
## Find: reuse, then extend, then invent
|
|
334
|
+
- \`${command} find <term>\` searches ids, aliases, names, keywords, summaries, import paths, slots
|
|
335
|
+
and code paths; \`--platform\`, \`--layer\` and \`--status\` narrow it (an empty term lists all
|
|
336
|
+
that pass). Run it before building anything new, in this order:
|
|
337
|
+
1. **Reuse**: a feature already does it. Use it as is, configured through its \`slots\`.
|
|
338
|
+
2. **Extend**: one is close. Fill a slot, or add a variant with \`extends: <id>\`.
|
|
339
|
+
3. **Invent**: nothing is close. Add an entry first (an \`idea\` is enough), then build.
|
|
284
340
|
|
|
285
341
|
## Add
|
|
286
342
|
1. Add an entry to \`${source}\`. The key is the id: lowercase, permanent, never reused.
|
|
287
343
|
Required: \`name\`, \`summary\` (internal, one sentence), \`status\`, \`owner\`, \`apps\`, \`audience\`.
|
|
344
|
+
- \`idea\`: captured, not agreed. Nothing else is required; add \`keywords\` so \`find\` matches it.
|
|
288
345
|
- \`planned\` needs a \`horizon\` (now, next, later). No dates on the roadmap.
|
|
289
346
|
- \`building\`: set \`claimedBy\` to your name or session while you work on it.
|
|
290
347
|
- \`beta\` and \`live\` need \`acceptance\`: one testable sentence each. Tag the tests that prove
|
|
@@ -293,6 +350,10 @@ description: Find, add, change and retire this repo's features in ${source}, and
|
|
|
293
350
|
- \`visibility\` (internal, customer, public, client:<name>) and \`access\` ("all" or { plan }).
|
|
294
351
|
Paid access is \`access\`, never a flag. The id is the billing entitlement's lookup key.
|
|
295
352
|
- For a public page: \`tagline\` (the customer benefit), \`category\`, \`media\`, \`highlight\`.
|
|
353
|
+
- For reuse: \`layer\` (token, primitive, pattern, layout, hook, provider, block, service, tool),
|
|
354
|
+
\`platforms\` (status per platform when it differs), \`entry\` (what to import, per platform),
|
|
355
|
+
\`keywords\`, \`slots\`, \`extends\` (the feature this is a variant of), \`requires\` (a beta or
|
|
356
|
+
live feature can't require an idea, a planned or a retired one) and \`contributes\`.
|
|
296
357
|
2. Flags go in the flags registry with \`feature: <id>\`. One flag per feature; a second needs a
|
|
297
358
|
\`splitReason\`. \`release\` and \`experiment\` flags need \`expires\`, \`ops\` flags a \`runbook\`.
|
|
298
359
|
Read flags only through the typed accessor with a literal key, never a computed one.
|
|
@@ -300,8 +361,8 @@ description: Find, add, change and retire this repo's features in ${source}, and
|
|
|
300
361
|
its body) or the PR (a \`feature:<id>\` label).
|
|
301
362
|
|
|
302
363
|
## Change
|
|
303
|
-
- Move \`status\` as it ships: planned, building, beta, live, deprecated, retired. \`check\` warns
|
|
304
|
-
planned feature already has shipped work tagged with it (a changeset, or with \`--prs\` a merged PR).
|
|
364
|
+
- Move \`status\` as it ships: idea, planned, building, beta, live, deprecated, retired. \`check\` warns
|
|
365
|
+
when an idea or a planned feature already has shipped work tagged with it (a changeset, or with \`--prs\` a merged PR).
|
|
305
366
|
- Set \`reviewedAt\` (today) whenever you check an entry against the product; \`check\` warns after 90 days.
|
|
306
367
|
- Rename by giving the feature a new id and putting the old one in \`aliases\`. Never delete an id.
|
|
307
368
|
|
|
@@ -314,6 +375,6 @@ description: Find, add, change and retire this repo's features in ${source}, and
|
|
|
314
375
|
`;
|
|
315
376
|
}
|
|
316
377
|
|
|
317
|
-
export { AGENTS_BLOCK_END, AGENTS_BLOCK_START, BrokenBlockError, FEATURE_HORIZONS, FEATURE_STATUSES, FLAG_KINDS, FeatureRegistryError, MARKETING_BLOCK_END, MARKETING_BLOCK_START, OPENFEATURE_MANIFEST_SCHEMA, defineFeatures, defineFlags, expiredFlags, featureSchema, findFeatures, flagSchema, flagsForFeature, marketingRecords, readAgentsBlock, readBlock, replaceAgentsBlock, replaceBlock, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toRecords, toSkillMarkdown };
|
|
318
|
-
//# sourceMappingURL=chunk-
|
|
319
|
-
//# sourceMappingURL=chunk-
|
|
378
|
+
export { AGENTS_BLOCK_END, AGENTS_BLOCK_START, BrokenBlockError, FEATURE_HORIZONS, FEATURE_LAYERS, FEATURE_STATUSES, FLAG_KINDS, FeatureRegistryError, MARKETING_BLOCK_END, MARKETING_BLOCK_START, OPENFEATURE_MANIFEST_SCHEMA, defineFeatures, defineFlags, expiredFlags, featureSchema, findFeatures, flagSchema, flagsForFeature, marketingRecords, readAgentsBlock, readBlock, replaceAgentsBlock, replaceBlock, statusOn, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toRecords, toSkillMarkdown };
|
|
379
|
+
//# sourceMappingURL=chunk-KCUQY5UZ.js.map
|
|
380
|
+
//# sourceMappingURL=chunk-KCUQY5UZ.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/model.ts","../src/generate.ts"],"names":[],"mappings":"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","file":"chunk-KCUQY5UZ.js","sourcesContent":["import { z } from \"zod\";\nimport { cycleProblems, requirementProblem } from \"./graph\";\nimport { FEATURE_PLATFORMS, type FeaturePlatform } from \"./platforms\";\n\n/**\n * Where a feature is in its life. The order is the board's column order.\n * `idea` is captured but not agreed: it is in the list so `find` turns it up\n * before someone builds the same thing twice.\n *\n * @stability Beta\n */\nexport const FEATURE_STATUSES = [\"idea\", \"planned\", \"building\", \"beta\", \"live\", \"deprecated\", \"retired\"] as const;\n\n/** @stability Beta */\nexport type FeatureStatus = (typeof FEATURE_STATUSES)[number];\n\n/**\n * When a planned or building feature is due, without dates: the roadmap's\n * three columns.\n *\n * @stability Beta\n */\nexport const FEATURE_HORIZONS = [\"now\", \"next\", \"later\"] as const;\n\n/** @stability Beta */\nexport type FeatureHorizon = (typeof FEATURE_HORIZONS)[number];\n\n/**\n * Who may see a feature listed. `public` features with a `tagline` go on\n * marketing output; `client:<name>` is one customer's own feature.\n *\n * @stability Beta\n */\nexport type FeatureVisibility = \"internal\" | \"customer\" | \"public\" | `client:${string}`;\n\n/**\n * Who gets a feature: everyone, or one paid plan. The feature id doubles as\n * the billing entitlement's lookup key (a Stripe `lookup_key`).\n *\n * @stability Beta\n */\nexport type FeatureAccess = \"all\" | { plan: string };\n\n/**\n * Pointers from a feature to where it lives. `code` paths are relative to the\n * repository root and `genesis features check` fails when one doesn't exist.\n *\n * @stability Beta\n */\nexport interface FeatureLinks {\n /** Files or folders that implement the feature, relative to the repo root. */\n code?: readonly string[];\n /** Docs: a repo-relative path or a URL. */\n docs?: readonly string[];\n /** The tracking issue: a URL, `#123` or `owner/repo#123`. */\n issue?: string;\n}\n\n// Where a feature runs: in its own file so the zod-free blocks entry shares it.\nexport { FEATURE_PLATFORMS, type FeaturePlatform };\n\n/**\n * What kind of thing a feature is, from smallest to largest, so an agent\n * looking for a building block can tell a primitive from a whole block:\n * `token`, `primitive` (one component), `pattern` (a composed component with\n * slots), `layout` (a page or screen shell), `hook`, `provider` (data or\n * context), `block` (a feature an app adds whole: UI, data and server),\n * `service` (server code) and `tool` (CLI, CI, devtools).\n *\n * @stability Beta\n */\nexport const FEATURE_LAYERS = [\"token\", \"primitive\", \"pattern\", \"layout\", \"hook\", \"provider\", \"block\", \"service\", \"tool\"] as const;\n\n/** @stability Beta */\nexport type FeatureLayer = (typeof FEATURE_LAYERS)[number];\n\n/** A picture or video for a marketing page. @stability Beta */\nexport interface FeatureMedia {\n image?: string;\n video?: string;\n alt: string;\n}\n\n/**\n * One feature. The object key in {@link defineFeatures} is its id: permanent,\n * never reused, and renamed only through `aliases`.\n *\n * @stability Beta\n */\nexport interface FeatureDef {\n name: string;\n /** One sentence for the team: what it does for whom. */\n summary: string;\n status: FeatureStatus;\n /** Who answers for it: a person, a team or an agent session's name. */\n owner: string;\n /** Which of the repo's apps or surfaces carry it, e.g. `[\"web\"]`. */\n apps: readonly string[];\n /** Who it is for, e.g. `[\"client\", \"coach\"]`. */\n audience: readonly string[];\n /** Roadmap column. Only on planned (required) or building features. */\n horizon?: FeatureHorizon;\n /** Default `customer`. */\n visibility?: FeatureVisibility;\n /** Default `all`. */\n access?: FeatureAccess;\n /** One testable sentence each. Required on beta and live features. */\n acceptance?: readonly string[];\n /** Ids this feature had before. An old id can't be reused. */\n aliases?: readonly string[];\n /** When someone last checked this entry against the product: `YYYY-MM-DD`. */\n reviewedAt?: string;\n /** Who is building it right now. Only on building features. */\n claimedBy?: string;\n /** When it first shipped or started: `YYYY-MM-DD` or `YYYY-MM`. */\n since?: string;\n links?: FeatureLinks;\n /** One line of benefit, for customers. Needed for marketing output. */\n tagline?: string;\n /** A group on a marketing page. */\n category?: string;\n media?: FeatureMedia;\n /** A hero item on a marketing page. */\n highlight?: boolean;\n /** What kind of thing it is. */\n layer?: FeatureLayer;\n /**\n * Status per platform, when it differs from `status`: `{ web: \"live\", native: \"planned\" }`.\n * A platform left out doesn't have it.\n */\n platforms?: Partial<Record<FeaturePlatform, FeatureStatus>>;\n /** What to import, per platform, e.g. `{ web: \"@marktiderman/genesis-ui/settings-row\" }`. */\n entry?: Partial<Record<FeaturePlatform, string>>;\n /** Other words people use for it, so `find` matches them: `[\"chat\", \"dm\"]`. */\n keywords?: readonly string[];\n /** The feature this one is a variant of. */\n extends?: string;\n /** Features it needs. A beta or live feature can't require an idea, a planned or a retired one. */\n requires?: readonly string[];\n /** What it adds to an app, e.g. `[\"nav item\", \"settings row\", \"table: threads\"]`. */\n contributes?: readonly string[];\n /** The parts an app can replace or drop through `slots`. */\n slots?: readonly string[];\n}\n\n/**\n * Why a flag exists. `release` and `experiment` flags need `expires`, `ops`\n * flags need a `runbook`, and `permission` flags fail `check`: paid access\n * belongs in entitlements (`access`), not flags.\n *\n * @stability Beta\n */\nexport const FLAG_KINDS = [\"release\", \"experiment\", \"ops\", \"permission\"] as const;\n\n/** @stability Beta */\nexport type FlagKind = (typeof FLAG_KINDS)[number];\n\n/** A flag's default: anything an OpenFeature flag can hold. */\nexport type FlagValue = boolean | string | number | { readonly [key: string]: unknown };\n\n/**\n * One flag. `feature` names the {@link FeatureDef} it belongs to; a feature's\n * flags are found by reverse lookup ({@link flagsForFeature}) and never\n * written on the feature itself.\n *\n * @stability Beta\n */\nexport interface FlagDef<F extends string = string> {\n feature: F;\n kind: FlagKind;\n owner: string;\n default: FlagValue;\n /** Where it can be set, e.g. `[\"platform\", \"practice\", \"user\"]`. */\n scopes: readonly string[];\n description?: string;\n /** `YYYY-MM-DD`. Required on release and experiment flags; `check` fails after it. */\n expires?: string;\n /** What to do when you flip it: a repo path or a URL. Required on ops flags. */\n runbook?: string;\n /**\n * Flags are grouped by feature: one flag per feature by default. Every flag\n * after a feature's first must say why it is a separate flag.\n */\n splitReason?: string;\n}\n\n/** The id type of a features object: `type FeatureId = FeatureIdOf<typeof features>`. */\nexport type FeatureIdOf<T> = Extract<keyof T, string>;\n\n/** A features object as {@link defineFeatures} returns it. */\nexport type Features<Id extends string = string> = { readonly [K in Id]: FeatureDef };\n\n/** A flags object as {@link defineFlags} returns it. */\nexport type Flags<F extends string = string> = { readonly [name: string]: FlagDef<F> };\n\nconst ID = /^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*$/;\nconst DAY = /^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/;\nconst MONTH_OR_DAY = /^\\d{4}-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?$/;\nconst URL_RE = /^https?:\\/\\/\\S+$/;\nconst ISSUE = /^(https?:\\/\\/\\S+|([\\w.-]+\\/[\\w.-]+)?#\\d+)$/;\n\nconst text = z.string().trim().min(1);\nconst day = z.string().regex(DAY, \"must be YYYY-MM-DD\");\n\n/** A repo-relative path that stays inside the repo. */\nconst repoPath = text.refine(\n (p) => !p.startsWith(\"/\") && !/^[a-z]:/i.test(p) && !p.split(/[\\\\/]/).includes(\"..\"),\n { message: \"must be a path relative to the repo root, without ..\" },\n);\nconst pathOrUrl = z.union([z.string().regex(URL_RE), repoPath]);\n\nconst linksSchema = z\n .object({\n code: z.array(repoPath).optional(),\n docs: z.array(pathOrUrl).optional(),\n issue: z.string().regex(ISSUE, \"must be a URL, #123 or owner/repo#123\").optional(),\n })\n .strict();\n\nconst visibilitySchema = z.union([\n z.enum([\"internal\", \"customer\", \"public\"]),\n z.string().regex(/^client:\\S+$/, \"must be internal, customer, public or client:<name>\"),\n]);\n\n/** `{ web?, native?, server?, cli? }`, each holding `value`. (Not `z.partialRecord`, which zod 3 lacks.) */\nconst perPlatform = <T extends z.ZodTypeAny>(value: T) =>\n z.object(Object.fromEntries(FEATURE_PLATFORMS.map((p) => [p, value.optional()])) as Record<FeaturePlatform, z.ZodOptional<T>>).strict();\n\n/** The Zod schema for one {@link FeatureDef}, field by field. Cross-field rules live in {@link featureProblems}. */\nexport const featureSchema = z\n .object({\n name: text,\n summary: text,\n status: z.enum(FEATURE_STATUSES),\n owner: text,\n apps: z.array(text).min(1),\n audience: z.array(text).min(1),\n horizon: z.enum(FEATURE_HORIZONS).optional(),\n visibility: visibilitySchema.optional(),\n access: z.union([z.literal(\"all\"), z.object({ plan: text }).strict()]).optional(),\n acceptance: z.array(text).optional(),\n aliases: z.array(z.string().regex(ID, \"must be a feature id\")).optional(),\n reviewedAt: day.optional(),\n claimedBy: text.optional(),\n since: z.string().regex(MONTH_OR_DAY, \"must be YYYY-MM-DD or YYYY-MM\").optional(),\n links: linksSchema.optional(),\n tagline: text.optional(),\n category: text.optional(),\n media: z\n .object({ image: pathOrUrl.optional(), video: pathOrUrl.optional(), alt: text })\n .strict()\n .optional(),\n highlight: z.boolean().optional(),\n layer: z.enum(FEATURE_LAYERS).optional(),\n platforms: perPlatform(z.enum(FEATURE_STATUSES)).optional(),\n entry: perPlatform(text).optional(),\n keywords: z.array(text).optional(),\n extends: z.string().regex(ID, \"must be a feature id\").optional(),\n requires: z.array(z.string().regex(ID, \"must be a feature id\")).optional(),\n contributes: z.array(text).optional(),\n slots: z.array(text).optional(),\n })\n .strict();\n\nconst flagValue: z.ZodType<FlagValue> = z.union([z.boolean(), z.string(), z.number(), z.record(z.string(), z.unknown())]);\n\n/** The Zod schema for one {@link FlagDef}. Cross-flag rules live in {@link defineFlags}. */\nexport const flagSchema = z\n .object({\n feature: text,\n kind: z.enum(FLAG_KINDS),\n owner: text,\n default: flagValue,\n scopes: z.array(text).min(1),\n description: text.optional(),\n expires: day.optional(),\n runbook: pathOrUrl.optional(),\n splitReason: text.optional(),\n })\n .strict();\n\n/** Thrown by {@link defineFeatures} and {@link defineFlags}; lists every problem at once. */\nexport class FeatureRegistryError extends Error {\n constructor(readonly problems: string[]) {\n super(`Invalid feature registry:\\n${problems.map((p) => ` - ${p}`).join(\"\\n\")}`);\n this.name = \"FeatureRegistryError\";\n }\n}\n\nfunction issues(prefix: string, error: z.ZodError): string[] {\n return error.issues.map((i) => `${[prefix, ...i.path].join(\".\")}: ${i.message}`);\n}\n\n/** The rules between one feature's fields, as problem strings. */\nfunction featureProblems(id: string, def: FeatureDef): string[] {\n const problems: string[] = [];\n const early = def.status === \"planned\" || def.status === \"building\";\n if (def.horizon && !early) problems.push(`${id}.horizon: only planned and building features are on the roadmap`);\n if (def.status === \"planned\" && !def.horizon) problems.push(`${id}.horizon: a planned feature needs now, next or later`);\n if ((def.status === \"beta\" || def.status === \"live\") && !def.acceptance?.length) {\n problems.push(`${id}.acceptance: a ${def.status} feature needs at least one testable sentence`);\n }\n if (def.claimedBy && def.status !== \"building\") problems.push(`${id}.claimedBy: only a building feature can be claimed`);\n if (def.media && !def.media.image && !def.media.video) problems.push(`${id}.media: needs an image or a video`);\n return problems;\n}\n\n/**\n * The one source of truth for a repo's features. Validates every entry and\n * returns the same object, so running code reads it directly and the key type\n * becomes the repo's `FeatureId`:\n *\n * ```ts\n * export const features = defineFeatures({\n * tasks: { name: \"Tasks\", summary: \"…\", status: \"live\", owner: \"mark\", apps: [\"web\"], audience: [\"client\"],\n * acceptance: [\"A client can tick off a task their coach added.\"] },\n * });\n * export type FeatureId = FeatureIdOf<typeof features>;\n * ```\n *\n * @stability Beta\n */\nexport function defineFeatures<const T extends Record<string, FeatureDef>>(features: T): T {\n const problems: string[] = [];\n const invalid = new Set<string>();\n const owners = new Map<string, string>();\n for (const [id, def] of Object.entries(features)) {\n if (!ID.test(id)) problems.push(`${id}: the id must be lowercase letters and digits, joined by -, _ or .`);\n const parsed = featureSchema.safeParse(def);\n if (!parsed.success) {\n problems.push(...issues(id, parsed.error));\n invalid.add(id);\n continue;\n }\n problems.push(...featureProblems(id, def));\n for (const name of [id, ...(def.aliases ?? [])]) {\n const other = owners.get(name);\n if (other !== undefined) problems.push(`${id}: \"${name}\" is already ${other === name ? \"a feature id\" : `an alias of ${other}`}`);\n else owners.set(name, id);\n }\n }\n problems.push(...relationProblems(features, invalid));\n if (problems.length) throw new FeatureRegistryError(problems);\n return Object.freeze(features);\n}\n\nconst UNSHIPPED: readonly FeatureStatus[] = [\"idea\", \"planned\", \"retired\"];\n\n/** `extends` and `requires` name real, distinct features; `requires` has no cycles; shipped features need shipped ones. */\nfunction relationProblems(features: Record<string, FeatureDef>, skip: ReadonlySet<string>): string[] {\n const problems: string[] = [];\n const has = (id: string) => Object.hasOwn(features, id);\n for (const [id, def] of Object.entries(features)) {\n // A schema-invalid entry is already reported; its fields can't be trusted here.\n if (skip.has(id)) continue;\n if (def.extends !== undefined) {\n if (def.extends === id) problems.push(`${id}.extends: a feature can't extend itself`);\n else if (!has(def.extends)) problems.push(`${id}.extends: \"${def.extends}\" is not a feature`);\n }\n // Itself and unknown ids: the same checks `resolveBlocks` runs on blocks.\n for (const req of def.requires ?? []) {\n const problem = requirementProblem(features, id, req, { noun: \"feature\" });\n if (problem) problems.push(problem);\n else if (!skip.has(req) && (def.status === \"beta\" || def.status === \"live\") && UNSHIPPED.includes(features[req]!.status)) {\n problems.push(`${id}.requires: a ${def.status} feature can't require \"${req}\", which is ${features[req]!.status}`);\n }\n }\n }\n problems.push(...cycleProblems(features, skip));\n return problems;\n}\n\n/**\n * Flags, each tied to a feature of `features`. An unknown `feature` is a type\n * error, and at runtime:\n * - every flag needs an `owner`, a `kind`, a `default` and its `scopes`;\n * - `release` and `experiment` flags need an `expires` date, `ops` flags a `runbook`;\n * - a feature's second (third, …) flag needs a `splitReason`, because flags\n * are grouped by feature unless there's a stated reason to split.\n *\n * `permission` flags are accepted here so the app still runs, and refused by\n * `genesis features check`.\n *\n * @stability Beta\n */\nexport function defineFlags<F extends string, const T extends Record<string, FlagDef<NoInfer<F>>>>(\n features: { readonly [K in F]: FeatureDef },\n flags: T,\n): T {\n const problems: string[] = [];\n const seen = new Map<string, string>();\n for (const [name, def] of Object.entries(flags)) {\n const parsed = flagSchema.safeParse(def);\n if (!parsed.success) {\n problems.push(...issues(name, parsed.error));\n continue;\n }\n const flag = parsed.data;\n if (!Object.hasOwn(features, flag.feature)) problems.push(`${name}.feature: \"${flag.feature}\" is not a feature`);\n if ((flag.kind === \"release\" || flag.kind === \"experiment\") && !flag.expires) {\n problems.push(`${name}.expires: a ${flag.kind} flag needs an expiry date`);\n }\n if (flag.kind === \"ops\" && !flag.runbook) problems.push(`${name}.runbook: an ops flag needs a runbook`);\n const first = seen.get(flag.feature);\n if (first === undefined) seen.set(flag.feature, name);\n else if (!flag.splitReason)\n problems.push(`${name}.splitReason: \"${flag.feature}\" already has the flag ${first}; say why this one is separate`);\n }\n if (problems.length) throw new FeatureRegistryError(problems);\n return Object.freeze(flags);\n}\n\n/**\n * The names of the flags that belong to a feature, in declaration order.\n *\n * @stability Beta\n */\nexport function flagsForFeature(flags: Flags | undefined, id: string): string[] {\n if (!flags) return [];\n return Object.entries(flags)\n .filter(([, flag]) => flag.feature === id)\n .map(([name]) => name);\n}\n\n/**\n * Flags whose `expires` date is before `today` (`YYYY-MM-DD`, default today in\n * UTC): remove the code path, then the flag.\n *\n * @stability Beta\n */\nexport function expiredFlags(flags: Flags | undefined, today = new Date().toISOString().slice(0, 10)): string[] {\n if (!flags) return [];\n return Object.entries(flags)\n .filter(([, flag]) => flag.expires !== undefined && flag.expires < today)\n .map(([name]) => name);\n}\n\n/**\n * A feature flattened for a list, a board or JSON: its id, its fields with\n * defaults filled in, and the names of its flags.\n *\n * @stability Beta\n */\nexport interface FeatureRecord extends FeatureDef {\n [key: string]: unknown;\n id: string;\n visibility: FeatureVisibility;\n access: FeatureAccess;\n flags: string[];\n}\n\n/**\n * Features as records, in declaration order, each with its flags attached.\n *\n * @stability Beta\n */\nexport function toRecords(features: Features, flags?: Flags): FeatureRecord[] {\n return Object.entries(features).map(([id, def]) => ({\n id,\n ...def,\n visibility: def.visibility ?? \"customer\",\n access: def.access ?? \"all\",\n flags: flagsForFeature(flags, id),\n }));\n}\n\n/**\n * Narrows {@link findFeatures}: only features on a platform (from `platforms`,\n * or `apps` when a feature has no `platforms`), of a layer, or in a status.\n *\n * @stability Beta\n */\nexport interface FindOptions {\n platform?: FeaturePlatform;\n layer?: FeatureLayer;\n status?: FeatureStatus;\n}\n\n/** A feature's status on one platform, or undefined when it isn't there. @stability Beta */\nexport function statusOn(def: FeatureDef, platform: FeaturePlatform): FeatureStatus | undefined {\n if (def.platforms) return def.platforms[platform];\n // Registries often call the server \"node\" in `apps`.\n const apps = def.apps.map((a) => (a === \"node\" ? \"server\" : a));\n return apps.includes(platform) ? def.status : undefined;\n}\n\n/**\n * Features matching `term` in their id, aliases, name, keywords, summary,\n * tagline, category, import paths, slots, contributions or code paths, best\n * matches (id, name and keywords) first. With `options` and an empty `term`,\n * every feature that passes the filters.\n *\n * @stability Beta\n */\nexport function findFeatures(features: Features, term: string, flags?: Flags, options: FindOptions = {}): FeatureRecord[] {\n const needle = term.trim().toLowerCase();\n const filtered = Boolean(options.platform || options.layer || options.status);\n if (!needle && !filtered) return [];\n const keep = (r: FeatureRecord) =>\n (!options.platform || statusOn(r, options.platform) !== undefined) &&\n (!options.layer || r.layer === options.layer) &&\n (!options.status || r.status === options.status);\n const score = (r: FeatureRecord) => {\n if (!needle) return 0;\n if (r.id === needle || r.aliases?.includes(needle)) return 0;\n if (r.id.includes(needle) || r.name.toLowerCase().includes(needle)) return 1;\n if (r.keywords?.some((k) => k.toLowerCase().includes(needle))) return 1;\n if (r.flags.some((f) => f.toLowerCase().includes(needle))) return 2;\n const rest = [\n r.summary,\n r.tagline,\n r.category,\n ...(r.links?.code ?? []),\n ...(r.aliases ?? []),\n ...Object.values(r.entry ?? {}),\n ...(r.slots ?? []),\n ...(r.contributes ?? []),\n ];\n return rest.some((v) => v?.toLowerCase().includes(needle)) ? 3 : -1;\n };\n return toRecords(features, flags)\n .filter(keep)\n .map((r) => [score(r), r] as const)\n .filter(([s]) => s >= 0)\n .sort((a, b) => a[0] - b[0])\n .map(([, r]) => r);\n}\n","import { FEATURE_STATUSES, toRecords, type FeatureRecord, type Features, type Flags, type FlagValue } from \"./model\";\n\n/** Marks the start of the generated block in AGENTS.md. */\nexport const AGENTS_BLOCK_START = \"<!-- genesis-features:start -->\";\n/** Marks the end of the generated block in AGENTS.md. */\nexport const AGENTS_BLOCK_END = \"<!-- genesis-features:end -->\";\n/** Marks the start of the generated marketing block (e.g. in README.md). */\nexport const MARKETING_BLOCK_START = \"<!-- genesis-features:marketing:start -->\";\n/** Marks the end of the generated marketing block. */\nexport const MARKETING_BLOCK_END = \"<!-- genesis-features:marketing:end -->\";\n\nexport interface GenerateOptions {\n /** The file the registry lives in, named in the \"generated from\" notes. Default `src/features.ts`. */\n source?: string;\n /** How agents run the CLI here, e.g. `genesis features` or `bun run features`. Default `genesis features`. */\n command?: string;\n /** Where the skill lives, named in the AGENTS.md pointer. Default `.claude/skills/features/SKILL.md`. */\n skill?: string | false;\n}\n\n/**\n * The registry as JSON, for tools that can't import TypeScript. Stable: no\n * timestamps, features in declaration order, so `check` can compare it. It is\n * also the record of every id ever used, which keeps ids permanent.\n *\n * @stability Beta\n */\nexport function toJson(features: Features, flags?: Flags, options: GenerateOptions = {}): string {\n const doc = {\n generatedFrom: options.source ?? \"src/features.ts\",\n features: toRecords(features, flags),\n flags: flags ?? {},\n };\n return `${JSON.stringify(doc, null, 2)}\\n`;\n}\n\nfunction flagType(value: FlagValue): string {\n if (typeof value === \"boolean\") return \"boolean\";\n if (typeof value === \"string\") return \"string\";\n if (typeof value === \"number\") return Number.isInteger(value) ? \"integer\" : \"float\";\n return \"object\";\n}\n\n/** The schema an OpenFeature CLI flag manifest points at. */\nexport const OPENFEATURE_MANIFEST_SCHEMA =\n \"https://raw.githubusercontent.com/open-feature/cli/refs/heads/main/schema/v0/flag-manifest.json\";\n\n/**\n * The flags as an OpenFeature CLI flag manifest (`flags.json`), so\n * `openfeature generate` can make typed accessors from the same registry.\n *\n * @stability Beta\n */\nexport function toOpenFeatureManifest(flags: Flags, features?: Features): string {\n const manifest = {\n $schema: OPENFEATURE_MANIFEST_SCHEMA,\n flags: Object.fromEntries(\n Object.entries(flags).map(([key, flag]) => [\n key,\n {\n flagType: flagType(flag.default),\n defaultValue: flag.default,\n description: flag.description ?? `${flag.kind} flag for ${features?.[flag.feature]?.name ?? flag.feature}`,\n },\n ]),\n ),\n };\n return `${JSON.stringify(manifest, null, 2)}\\n`;\n}\n\nconst cell = (value: string) => value.replace(/\\|/g, \"\\\\|\").replace(/\\r?\\n/g, \" \");\n\n/**\n * The marker-delimited block for AGENTS.md: deliberately short. It points\n * agents at `find` and the skill and gives counts, never the whole list, so\n * AGENTS.md stays small however many features there are.\n *\n * @stability Beta\n */\nexport function toAgentsMarkdown(features: Features, flags?: Flags, options: GenerateOptions = {}): string {\n const source = options.source ?? \"src/features.ts\";\n const command = options.command ?? \"genesis features\";\n const skill = options.skill === undefined ? \".claude/skills/features/SKILL.md\" : options.skill;\n const records = toRecords(features, flags);\n const counts = FEATURE_STATUSES.map((s) => [s, records.filter((r) => r.status === s).length] as const)\n .filter(([, n]) => n > 0)\n .map(([s, n]) => `${n} ${s}`)\n .join(\", \");\n const flagCount = flags ? Object.keys(flags).length : 0;\n const lines = [\n AGENTS_BLOCK_START,\n \"## Features\",\n \"\",\n `Every feature is in \\`${source}\\`: ${records.length} features (${counts})${flagCount ? `, ${flagCount} flag${flagCount === 1 ? \"\" : \"s\"}` : \"\"}.`,\n \"\",\n `- Before adding UI, routes or flags, run \\`${command} find <term>\\` to see whether a feature already covers it.`,\n `- New work starts as an entry in \\`${source}\\`; then run \\`${command} build\\`. \\`${command} check\\` runs in CI.`,\n ...(skill ? [`- Finding, adding and retiring features: \\`${skill}\\`.`] : []),\n \"\",\n `Generated by \\`${command} build\\`. Don't edit this block.`,\n AGENTS_BLOCK_END,\n ];\n return lines.join(\"\\n\");\n}\n\n/** The public, shipped features a marketing page shows: visibility public, a tagline, live or beta. */\nexport function marketingRecords(features: Features): FeatureRecord[] {\n return toRecords(features)\n .filter((r) => r.visibility === \"public\" && r.tagline && (r.status === \"live\" || r.status === \"beta\"))\n .sort((a, b) => Number(Boolean(b.highlight)) - Number(Boolean(a.highlight)));\n}\n\n/**\n * A benefit-led feature list for a README or a marketing page: public, shipped\n * features with a tagline, highlights first, grouped by category.\n *\n * @stability Beta\n */\nexport function toMarketingMarkdown(features: Features, options: { heading?: string; source?: string } = {}): string {\n const records = marketingRecords(features);\n const lines = [MARKETING_BLOCK_START, `## ${options.heading ?? \"Features\"}`, \"\"];\n const highlights = records.filter((r) => r.highlight);\n for (const r of highlights) lines.push(`- **${cell(r.name)}** — ${cell(r.tagline!)}`);\n if (highlights.length) lines.push(\"\");\n const categories = [...new Set(records.filter((r) => !r.highlight).map((r) => r.category ?? \"More\"))];\n for (const category of categories) {\n lines.push(`### ${category}`, \"\");\n for (const r of records.filter((x) => !x.highlight && (x.category ?? \"More\") === category)) {\n lines.push(`- **${cell(r.name)}**${r.status === \"beta\" ? \" (beta)\" : \"\"} — ${cell(r.tagline!)}`);\n }\n lines.push(\"\");\n }\n lines.push(`<sub>Generated from \\`${options.source ?? \"src/features.ts\"}\\`.</sub>`, MARKETING_BLOCK_END);\n return lines.join(\"\\n\");\n}\n\n/** Thrown when a generated block's markers are broken: one is missing, repeated or out of order. */\nexport class BrokenBlockError extends Error {\n constructor(start: string) {\n super(`The generated block's markers are broken (${start} and its end marker must each appear once, in order). Fix them by hand, or delete both and the block between them.`);\n this.name = \"BrokenBlockError\";\n }\n}\n\nconst count = (doc: string, marker: string) => doc.split(marker).length - 1;\n\n/**\n * The block between `start` and `end` inside `doc`, markers included, or null\n * when there is none. Throws {@link BrokenBlockError} when only one marker is\n * there, or either is repeated or out of order, rather than guess where the\n * block ends and wipe the text after it.\n */\nexport function readBlock(doc: string, start: string, end: string): string | null {\n const starts = count(doc, start);\n const ends = count(doc, end);\n if (starts === 0 && ends === 0) return null;\n const from = doc.indexOf(start);\n const to = doc.indexOf(end);\n if (starts !== 1 || ends !== 1 || to < from) throw new BrokenBlockError(start);\n return doc.slice(from, to + end.length);\n}\n\n/**\n * `doc` with the block between `start` and `end` replaced by `block`, or with\n * `block` appended when it has none yet. Everything outside the markers is\n * left as it was.\n */\nexport function replaceBlock(doc: string, block: string, start: string, end: string): string {\n const current = readBlock(doc, start, end);\n if (current !== null) return doc.replace(current, () => block);\n const base = doc.length === 0 || doc.endsWith(\"\\n\") ? doc : `${doc}\\n`;\n return `${base}${base.length ? \"\\n\" : \"\"}${block}\\n`;\n}\n\n/** The generated AGENTS.md block inside `doc`, or null. */\nexport const readAgentsBlock = (doc: string) => readBlock(doc, AGENTS_BLOCK_START, AGENTS_BLOCK_END);\n\n/**\n * `doc` with its generated AGENTS.md block replaced by `block`, or with\n * `block` appended when it has none yet.\n *\n * @stability Beta\n */\nexport const replaceAgentsBlock = (doc: string, block: string) => replaceBlock(doc, block, AGENTS_BLOCK_START, AGENTS_BLOCK_END);\n\n/**\n * The agent skill for working with the registry, written to\n * `.claude/skills/features/SKILL.md` by `genesis features build`. `outputs`\n * names what the build writes in this repo, so the skill never claims a file\n * the repo turned off.\n *\n * @stability Beta\n */\nexport function toSkillMarkdown(options: GenerateOptions & { outputs?: readonly string[] } = {}): string {\n const source = options.source ?? \"src/features.ts\";\n const command = options.command ?? \"genesis features\";\n const outputs = options.outputs ?? [\"the AGENTS.md block\", \"features.json\", \"this skill\"];\n return `---\nname: features\ndescription: Find, add, change and retire this repo's features in ${source}, and their flags. Use before adding UI, a route, a server function or a flag, when someone asks what the product does, or when shipping, deprecating or removing something.\n---\n\n<!-- Generated by \\`${command} build\\`. Don't edit; it is rewritten. -->\n\n# Features\n\n\\`${source}\\` is the one list of what this product does. Running code imports it, and\n\\`${command} build\\` generates the rest from it: ${outputs.join(\", \")}.\n\n## Find: reuse, then extend, then invent\n- \\`${command} find <term>\\` searches ids, aliases, names, keywords, summaries, import paths, slots\n and code paths; \\`--platform\\`, \\`--layer\\` and \\`--status\\` narrow it (an empty term lists all\n that pass). Run it before building anything new, in this order:\n 1. **Reuse**: a feature already does it. Use it as is, configured through its \\`slots\\`.\n 2. **Extend**: one is close. Fill a slot, or add a variant with \\`extends: <id>\\`.\n 3. **Invent**: nothing is close. Add an entry first (an \\`idea\\` is enough), then build.\n\n## Add\n1. Add an entry to \\`${source}\\`. The key is the id: lowercase, permanent, never reused.\n Required: \\`name\\`, \\`summary\\` (internal, one sentence), \\`status\\`, \\`owner\\`, \\`apps\\`, \\`audience\\`.\n - \\`idea\\`: captured, not agreed. Nothing else is required; add \\`keywords\\` so \\`find\\` matches it.\n - \\`planned\\` needs a \\`horizon\\` (now, next, later). No dates on the roadmap.\n - \\`building\\`: set \\`claimedBy\\` to your name or session while you work on it.\n - \\`beta\\` and \\`live\\` need \\`acceptance\\`: one testable sentence each. Tag the tests that prove\n them with \\`@feat:<id>\\` in a comment or the test name.\n - \\`links.code\\`: the files or folders that implement it. \\`check\\` fails when one is missing.\n - \\`visibility\\` (internal, customer, public, client:<name>) and \\`access\\` (\"all\" or { plan }).\n Paid access is \\`access\\`, never a flag. The id is the billing entitlement's lookup key.\n - For a public page: \\`tagline\\` (the customer benefit), \\`category\\`, \\`media\\`, \\`highlight\\`.\n - For reuse: \\`layer\\` (token, primitive, pattern, layout, hook, provider, block, service, tool),\n \\`platforms\\` (status per platform when it differs), \\`entry\\` (what to import, per platform),\n \\`keywords\\`, \\`slots\\`, \\`extends\\` (the feature this is a variant of), \\`requires\\` (a beta or\n live feature can't require an idea, a planned or a retired one) and \\`contributes\\`.\n2. Flags go in the flags registry with \\`feature: <id>\\`. One flag per feature; a second needs a\n \\`splitReason\\`. \\`release\\` and \\`experiment\\` flags need \\`expires\\`, \\`ops\\` flags a \\`runbook\\`.\n Read flags only through the typed accessor with a literal key, never a computed one.\n3. Run \\`${command} build\\` and commit what it writes. Tag the changeset (a \\`Features: <id>\\` line in\n its body) or the PR (a \\`feature:<id>\\` label).\n\n## Change\n- Move \\`status\\` as it ships: idea, planned, building, beta, live, deprecated, retired. \\`check\\` warns\n when an idea or a planned feature already has shipped work tagged with it (a changeset, or with \\`--prs\\` a merged PR).\n- Set \\`reviewedAt\\` (today) whenever you check an entry against the product; \\`check\\` warns after 90 days.\n- Rename by giving the feature a new id and putting the old one in \\`aliases\\`. Never delete an id.\n\n## Retire\n1. Remove the code first: the UI, routes, server functions and tests.\n2. Then remove its flags from the flags registry (the code that read them is gone, so \\`check\\`\n would flag them as unused).\n3. Set \\`status: \"retired\"\\`, keep the entry, and drop \\`links.code\\` paths that no longer exist.\n4. Run \\`${command} build\\` and \\`${command} check\\`.\n`;\n}\n"]}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
|
-
import { F as Features,
|
|
2
|
-
export {
|
|
1
|
+
import { F as Features, b as FeatureRecord, a as Flags } from './model-CW3d2gsf.js';
|
|
2
|
+
export { d as FEATURE_HORIZONS, e as FEATURE_LAYERS, f as FEATURE_STATUSES, g as FLAG_KINDS, h as FeatureAccess, i as FeatureDef, j as FeatureHorizon, k as FeatureIdOf, l as FeatureLayer, m as FeatureLinks, n as FeatureMedia, o as FeatureRegistryError, c as FeatureStatus, p as FeatureVisibility, q as FindOptions, r as FlagDef, s as FlagKind, t as FlagValue, u as defineFeatures, v as defineFlags, w as expiredFlags, x as featureSchema, y as findFeatures, z as flagSchema, A as flagsForFeature, B as statusOn, C as toRecords } from './model-CW3d2gsf.js';
|
|
3
|
+
export { BlockContributions, BlockDataUse, BlockDef, BlockError, BlockMigration, BlockNavItem, BlockPrivacy, BlockRoute, BlockSettingsRow, Contributed, EnabledBlocks, ResolveBlocksOptions, ResolvedBlocks, defineBlock, resolveBlocks } from './blocks.js';
|
|
4
|
+
export { a as FEATURE_PLATFORMS, F as FeaturePlatform } from './platforms-NR0liM8L.js';
|
|
3
5
|
import 'zod';
|
|
4
6
|
|
|
5
7
|
/** Marks the start of the generated block in AGENTS.md. */
|
|
@@ -80,4 +82,42 @@ declare function toSkillMarkdown(options?: GenerateOptions & {
|
|
|
80
82
|
outputs?: readonly string[];
|
|
81
83
|
}): string;
|
|
82
84
|
|
|
83
|
-
|
|
85
|
+
/**
|
|
86
|
+
* The `requires` graph checks shared by the feature registry
|
|
87
|
+
* (`defineFeatures`) and blocks (`resolveBlocks`). No zod here: blocks import
|
|
88
|
+
* this from a platform-neutral entry that ships to phones.
|
|
89
|
+
*/
|
|
90
|
+
/** A node with the ids it needs. */
|
|
91
|
+
interface RequiresNode {
|
|
92
|
+
readonly requires?: readonly string[];
|
|
93
|
+
}
|
|
94
|
+
interface RequiresProblemsOptions {
|
|
95
|
+
/** What a node is called in messages: `feature` or `block`. */
|
|
96
|
+
noun: string;
|
|
97
|
+
/** Whether an id may be required. Default: it is a node of the graph. */
|
|
98
|
+
isKnown?: (id: string) => boolean;
|
|
99
|
+
/** The message for a requirement `isKnown` refuses. Default `"x" is not a <noun>`. */
|
|
100
|
+
unknown?: (req: string, id: string) => string;
|
|
101
|
+
/** Nodes already reported invalid: their edges can't be trusted, so they are skipped. */
|
|
102
|
+
skip?: ReadonlySet<string>;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Self-requirements, unknown requirements and cycles through `requires`, as
|
|
106
|
+
* problem strings (`a.requires: …`). Each cycle is reported once, from where
|
|
107
|
+
* the depth-first search found it: `a.requires: a cycle: a → b → a`.
|
|
108
|
+
*
|
|
109
|
+
* @stability Beta
|
|
110
|
+
*/
|
|
111
|
+
declare function requiresProblems(nodes: Readonly<Record<string, RequiresNode>>, options: RequiresProblemsOptions): string[];
|
|
112
|
+
/** One requirement's problem (itself, or an unknown id), or undefined when it is fine. @stability Beta */
|
|
113
|
+
declare function requirementProblem(nodes: Readonly<Record<string, RequiresNode>>, id: string, req: string, options: RequiresProblemsOptions): string | undefined;
|
|
114
|
+
/** Cycles through `requires`, each reported once, from where the depth-first search found it. @stability Beta */
|
|
115
|
+
declare function cycleProblems(nodes: Readonly<Record<string, RequiresNode>>, skip?: ReadonlySet<string>): string[];
|
|
116
|
+
/**
|
|
117
|
+
* The ids in dependency order (what a node requires comes first), ties kept
|
|
118
|
+
* in the given order. Requirements outside `nodes` are ignored. Assumes no
|
|
119
|
+
* cycles ({@link requiresProblems} reports them).
|
|
120
|
+
*/
|
|
121
|
+
declare function dependencyOrder(nodes: Readonly<Record<string, RequiresNode>>): string[];
|
|
122
|
+
|
|
123
|
+
export { AGENTS_BLOCK_END, AGENTS_BLOCK_START, BrokenBlockError, FeatureRecord, Features, Flags, type GenerateOptions, MARKETING_BLOCK_END, MARKETING_BLOCK_START, OPENFEATURE_MANIFEST_SCHEMA, type RequiresNode, type RequiresProblemsOptions, cycleProblems, dependencyOrder, marketingRecords, readAgentsBlock, replaceAgentsBlock, requirementProblem, requiresProblems, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toSkillMarkdown };
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { BlockError, defineBlock, resolveBlocks } from './chunk-EF72JS5S.js';
|
|
2
|
+
export { AGENTS_BLOCK_END, AGENTS_BLOCK_START, BrokenBlockError, FEATURE_HORIZONS, FEATURE_LAYERS, FEATURE_STATUSES, FLAG_KINDS, FeatureRegistryError, MARKETING_BLOCK_END, MARKETING_BLOCK_START, OPENFEATURE_MANIFEST_SCHEMA, defineFeatures, defineFlags, expiredFlags, featureSchema, findFeatures, flagSchema, flagsForFeature, marketingRecords, readAgentsBlock, replaceAgentsBlock, statusOn, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toRecords, toSkillMarkdown } from './chunk-KCUQY5UZ.js';
|
|
3
|
+
export { FEATURE_PLATFORMS, cycleProblems, dependencyOrder, requirementProblem, requiresProblems } from './chunk-2ARZER3G.js';
|
|
2
4
|
//# sourceMappingURL=index.js.map
|
|
3
5
|
//# sourceMappingURL=index.js.map
|
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { F as FeaturePlatform } from './platforms-NR0liM8L.js';
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* Where a feature is in its life. The order is the board's column order.
|
|
6
|
+
* `idea` is captured but not agreed: it is in the list so `find` turns it up
|
|
7
|
+
* before someone builds the same thing twice.
|
|
5
8
|
*
|
|
6
9
|
* @stability Beta
|
|
7
10
|
*/
|
|
8
|
-
declare const FEATURE_STATUSES: readonly ["planned", "building", "beta", "live", "deprecated", "retired"];
|
|
11
|
+
declare const FEATURE_STATUSES: readonly ["idea", "planned", "building", "beta", "live", "deprecated", "retired"];
|
|
9
12
|
/** @stability Beta */
|
|
10
13
|
type FeatureStatus = (typeof FEATURE_STATUSES)[number];
|
|
11
14
|
/**
|
|
@@ -47,6 +50,20 @@ interface FeatureLinks {
|
|
|
47
50
|
/** The tracking issue: a URL, `#123` or `owner/repo#123`. */
|
|
48
51
|
issue?: string;
|
|
49
52
|
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* What kind of thing a feature is, from smallest to largest, so an agent
|
|
56
|
+
* looking for a building block can tell a primitive from a whole block:
|
|
57
|
+
* `token`, `primitive` (one component), `pattern` (a composed component with
|
|
58
|
+
* slots), `layout` (a page or screen shell), `hook`, `provider` (data or
|
|
59
|
+
* context), `block` (a feature an app adds whole: UI, data and server),
|
|
60
|
+
* `service` (server code) and `tool` (CLI, CI, devtools).
|
|
61
|
+
*
|
|
62
|
+
* @stability Beta
|
|
63
|
+
*/
|
|
64
|
+
declare const FEATURE_LAYERS: readonly ["token", "primitive", "pattern", "layout", "hook", "provider", "block", "service", "tool"];
|
|
65
|
+
/** @stability Beta */
|
|
66
|
+
type FeatureLayer = (typeof FEATURE_LAYERS)[number];
|
|
50
67
|
/** A picture or video for a marketing page. @stability Beta */
|
|
51
68
|
interface FeatureMedia {
|
|
52
69
|
image?: string;
|
|
@@ -94,6 +111,25 @@ interface FeatureDef {
|
|
|
94
111
|
media?: FeatureMedia;
|
|
95
112
|
/** A hero item on a marketing page. */
|
|
96
113
|
highlight?: boolean;
|
|
114
|
+
/** What kind of thing it is. */
|
|
115
|
+
layer?: FeatureLayer;
|
|
116
|
+
/**
|
|
117
|
+
* Status per platform, when it differs from `status`: `{ web: "live", native: "planned" }`.
|
|
118
|
+
* A platform left out doesn't have it.
|
|
119
|
+
*/
|
|
120
|
+
platforms?: Partial<Record<FeaturePlatform, FeatureStatus>>;
|
|
121
|
+
/** What to import, per platform, e.g. `{ web: "@marktiderman/genesis-ui/settings-row" }`. */
|
|
122
|
+
entry?: Partial<Record<FeaturePlatform, string>>;
|
|
123
|
+
/** Other words people use for it, so `find` matches them: `["chat", "dm"]`. */
|
|
124
|
+
keywords?: readonly string[];
|
|
125
|
+
/** The feature this one is a variant of. */
|
|
126
|
+
extends?: string;
|
|
127
|
+
/** Features it needs. A beta or live feature can't require an idea, a planned or a retired one. */
|
|
128
|
+
requires?: readonly string[];
|
|
129
|
+
/** What it adds to an app, e.g. `["nav item", "settings row", "table: threads"]`. */
|
|
130
|
+
contributes?: readonly string[];
|
|
131
|
+
/** The parts an app can replace or drop through `slots`. */
|
|
132
|
+
slots?: readonly string[];
|
|
97
133
|
}
|
|
98
134
|
/**
|
|
99
135
|
* Why a flag exists. `release` and `experiment` flags need `expires`, `ops`
|
|
@@ -149,6 +185,7 @@ declare const featureSchema: z.ZodObject<{
|
|
|
149
185
|
name: z.ZodString;
|
|
150
186
|
summary: z.ZodString;
|
|
151
187
|
status: z.ZodEnum<{
|
|
188
|
+
idea: "idea";
|
|
152
189
|
planned: "planned";
|
|
153
190
|
building: "building";
|
|
154
191
|
beta: "beta";
|
|
@@ -190,6 +227,66 @@ declare const featureSchema: z.ZodObject<{
|
|
|
190
227
|
alt: z.ZodString;
|
|
191
228
|
}, z.core.$strict>>;
|
|
192
229
|
highlight: z.ZodOptional<z.ZodBoolean>;
|
|
230
|
+
layer: z.ZodOptional<z.ZodEnum<{
|
|
231
|
+
token: "token";
|
|
232
|
+
primitive: "primitive";
|
|
233
|
+
pattern: "pattern";
|
|
234
|
+
layout: "layout";
|
|
235
|
+
hook: "hook";
|
|
236
|
+
provider: "provider";
|
|
237
|
+
block: "block";
|
|
238
|
+
service: "service";
|
|
239
|
+
tool: "tool";
|
|
240
|
+
}>>;
|
|
241
|
+
platforms: z.ZodOptional<z.ZodObject<{
|
|
242
|
+
web: z.ZodOptional<z.ZodEnum<{
|
|
243
|
+
idea: "idea";
|
|
244
|
+
planned: "planned";
|
|
245
|
+
building: "building";
|
|
246
|
+
beta: "beta";
|
|
247
|
+
live: "live";
|
|
248
|
+
deprecated: "deprecated";
|
|
249
|
+
retired: "retired";
|
|
250
|
+
}>>;
|
|
251
|
+
native: z.ZodOptional<z.ZodEnum<{
|
|
252
|
+
idea: "idea";
|
|
253
|
+
planned: "planned";
|
|
254
|
+
building: "building";
|
|
255
|
+
beta: "beta";
|
|
256
|
+
live: "live";
|
|
257
|
+
deprecated: "deprecated";
|
|
258
|
+
retired: "retired";
|
|
259
|
+
}>>;
|
|
260
|
+
server: z.ZodOptional<z.ZodEnum<{
|
|
261
|
+
idea: "idea";
|
|
262
|
+
planned: "planned";
|
|
263
|
+
building: "building";
|
|
264
|
+
beta: "beta";
|
|
265
|
+
live: "live";
|
|
266
|
+
deprecated: "deprecated";
|
|
267
|
+
retired: "retired";
|
|
268
|
+
}>>;
|
|
269
|
+
cli: z.ZodOptional<z.ZodEnum<{
|
|
270
|
+
idea: "idea";
|
|
271
|
+
planned: "planned";
|
|
272
|
+
building: "building";
|
|
273
|
+
beta: "beta";
|
|
274
|
+
live: "live";
|
|
275
|
+
deprecated: "deprecated";
|
|
276
|
+
retired: "retired";
|
|
277
|
+
}>>;
|
|
278
|
+
}, z.core.$strict>>;
|
|
279
|
+
entry: z.ZodOptional<z.ZodObject<{
|
|
280
|
+
web: z.ZodOptional<z.ZodString>;
|
|
281
|
+
native: z.ZodOptional<z.ZodString>;
|
|
282
|
+
server: z.ZodOptional<z.ZodString>;
|
|
283
|
+
cli: z.ZodOptional<z.ZodString>;
|
|
284
|
+
}, z.core.$strict>>;
|
|
285
|
+
keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
286
|
+
extends: z.ZodOptional<z.ZodString>;
|
|
287
|
+
requires: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
288
|
+
contributes: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
289
|
+
slots: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
193
290
|
}, z.core.$strict>;
|
|
194
291
|
/** The Zod schema for one {@link FlagDef}. Cross-flag rules live in {@link defineFlags}. */
|
|
195
292
|
declare const flagSchema: z.ZodObject<{
|
|
@@ -278,11 +375,26 @@ interface FeatureRecord extends FeatureDef {
|
|
|
278
375
|
*/
|
|
279
376
|
declare function toRecords(features: Features, flags?: Flags): FeatureRecord[];
|
|
280
377
|
/**
|
|
281
|
-
*
|
|
282
|
-
*
|
|
378
|
+
* Narrows {@link findFeatures}: only features on a platform (from `platforms`,
|
|
379
|
+
* or `apps` when a feature has no `platforms`), of a layer, or in a status.
|
|
380
|
+
*
|
|
381
|
+
* @stability Beta
|
|
382
|
+
*/
|
|
383
|
+
interface FindOptions {
|
|
384
|
+
platform?: FeaturePlatform;
|
|
385
|
+
layer?: FeatureLayer;
|
|
386
|
+
status?: FeatureStatus;
|
|
387
|
+
}
|
|
388
|
+
/** A feature's status on one platform, or undefined when it isn't there. @stability Beta */
|
|
389
|
+
declare function statusOn(def: FeatureDef, platform: FeaturePlatform): FeatureStatus | undefined;
|
|
390
|
+
/**
|
|
391
|
+
* Features matching `term` in their id, aliases, name, keywords, summary,
|
|
392
|
+
* tagline, category, import paths, slots, contributions or code paths, best
|
|
393
|
+
* matches (id, name and keywords) first. With `options` and an empty `term`,
|
|
394
|
+
* every feature that passes the filters.
|
|
283
395
|
*
|
|
284
396
|
* @stability Beta
|
|
285
397
|
*/
|
|
286
|
-
declare function findFeatures(features: Features, term: string, flags?: Flags): FeatureRecord[];
|
|
398
|
+
declare function findFeatures(features: Features, term: string, flags?: Flags, options?: FindOptions): FeatureRecord[];
|
|
287
399
|
|
|
288
|
-
export { type Features as F, type
|
|
400
|
+
export { flagsForFeature as A, statusOn as B, toRecords as C, type Features as F, type Flags as a, type FeatureRecord as b, type FeatureStatus as c, FEATURE_HORIZONS as d, FEATURE_LAYERS as e, FEATURE_STATUSES as f, FLAG_KINDS as g, type FeatureAccess as h, type FeatureDef as i, type FeatureHorizon as j, type FeatureIdOf as k, type FeatureLayer as l, type FeatureLinks as m, type FeatureMedia as n, FeatureRegistryError as o, type FeatureVisibility as p, type FindOptions as q, type FlagDef as r, type FlagKind as s, type FlagValue as t, defineFeatures as u, defineFlags as v, expiredFlags as w, featureSchema as x, findFeatures as y, flagSchema as z };
|
package/dist/node.d.ts
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import { F as Features,
|
|
1
|
+
import { F as Features, a as Flags } from './model-CW3d2gsf.js';
|
|
2
2
|
import 'zod';
|
|
3
|
+
import './platforms-NR0liM8L.js';
|
|
3
4
|
|
|
4
5
|
/**
|
|
5
6
|
* Where a repo keeps its registry's outputs and what `check` scans. Every
|
|
6
7
|
* path is relative to `root`; `false` turns an output or a scan off. The CLI
|
|
7
|
-
* reads these from `package.json
|
|
8
|
+
* reads these from genesis.config.json → `features` (or package.json → `"genesisFeatures"`), and its options win.
|
|
8
9
|
*
|
|
9
10
|
* @stability Beta
|
|
10
11
|
*/
|
|
@@ -75,7 +76,7 @@ interface FeatureEvidence {
|
|
|
75
76
|
/** Merged PRs by the feature id (or alias) on their `feature:<id>` label. */
|
|
76
77
|
prs?: Record<string, readonly FeaturePrEvidence[]>;
|
|
77
78
|
}
|
|
78
|
-
/** A feature still marked planned that already has shipped work tagged with it. @stability Beta */
|
|
79
|
+
/** A feature still marked planned (or an idea) that already has shipped work tagged with it. @stability Beta */
|
|
79
80
|
interface PlannedButShipped {
|
|
80
81
|
id: string;
|
|
81
82
|
/** Changeset files with a `Features: <id>` line. */
|
package/dist/node.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { BrokenBlockError, expiredFlags, toAgentsMarkdown, readAgentsBlock, replaceAgentsBlock, toJson, toOpenFeatureManifest, toSkillMarkdown, toMarketingMarkdown, readBlock, MARKETING_BLOCK_START, MARKETING_BLOCK_END, replaceBlock } from './chunk-
|
|
1
|
+
import { BrokenBlockError, expiredFlags, toAgentsMarkdown, readAgentsBlock, replaceAgentsBlock, toJson, toOpenFeatureManifest, toSkillMarkdown, toMarketingMarkdown, readBlock, MARKETING_BLOCK_START, MARKETING_BLOCK_END, replaceBlock } from './chunk-KCUQY5UZ.js';
|
|
2
|
+
import './chunk-2ARZER3G.js';
|
|
2
3
|
import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
|
|
3
4
|
import { join, dirname } from 'path';
|
|
4
5
|
|
|
@@ -315,7 +316,7 @@ function checkFeatureOutputs(options) {
|
|
|
315
316
|
if (!/^https?:\/\//.test(path) && !existsSync(join(root, path))) warnings.push(`${id}.links.docs: ${path} doesn't exist`);
|
|
316
317
|
}
|
|
317
318
|
if (def.claimedBy) claims.push([id, def.claimedBy]);
|
|
318
|
-
if (def.status !== "planned" && def.status !== "retired") {
|
|
319
|
+
if (def.status !== "idea" && def.status !== "planned" && def.status !== "retired") {
|
|
319
320
|
if (!def.reviewedAt) warnings.push(`${id}: never reviewed (set reviewedAt)`);
|
|
320
321
|
else if (def.reviewedAt < reviewCutoff) warnings.push(`${id}: last reviewed ${def.reviewedAt}, over ${options.reviewDays ?? 90} days ago`);
|
|
321
322
|
}
|
|
@@ -389,10 +390,10 @@ function checkFeatureOutputs(options) {
|
|
|
389
390
|
const plannedButShipped = [];
|
|
390
391
|
for (const [id, def] of Object.entries(features)) {
|
|
391
392
|
const found = shippedIn.get(id);
|
|
392
|
-
if (def.status !== "planned" || !found || !found.changesets.length && !found.prs.length) continue;
|
|
393
|
+
if (def.status !== "planned" && def.status !== "idea" || !found || !found.changesets.length && !found.prs.length) continue;
|
|
393
394
|
const prs = [...found.prs].sort((a, b) => a.number - b.number);
|
|
394
395
|
plannedButShipped.push({ id, changesets: found.changesets, prs });
|
|
395
|
-
warnings.push(`${id} is still planned, but ${and([...found.changesets, ...prs.map((p) => `PR #${p.number}`)])} shipped work for it`);
|
|
396
|
+
warnings.push(`${id} is still ${def.status === "idea" ? "an idea" : "planned"}, but ${and([...found.changesets, ...prs.map((p) => `PR #${p.number}`)])} shipped work for it`);
|
|
396
397
|
}
|
|
397
398
|
for (const label of options.labels ?? []) {
|
|
398
399
|
const id = /^feature:(.+)$/.exec(label.trim())?.[1];
|