@marktiderman/genesis-features 0.1.0 → 0.1.2
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 +3 -1
- package/dist/{chunk-YKNISEPJ.js → chunk-ZYWK7XPT.js} +5 -4
- package/dist/chunk-ZYWK7XPT.js.map +1 -0
- package/dist/index.d.ts +6 -2
- package/dist/index.js +1 -1
- package/dist/node.d.ts +18 -3
- package/dist/node.js +107 -7
- package/dist/node.js.map +1 -1
- package/dist/react.js +1 -1
- package/package.json +3 -3
- package/dist/chunk-YKNISEPJ.js.map +0 -1
package/README.md
CHANGED
|
@@ -114,7 +114,9 @@ The CLI reads settings from `package.json`, which also needs `"genesisFeatures"`
|
|
|
114
114
|
}
|
|
115
115
|
```
|
|
116
116
|
|
|
117
|
-
Other settings: `agents`, `claude`, `json`, `openfeature`, `skill` (each a path, or `false`), `scan`, `tests`, `coverageIgnore`, `changesets`, `reviewDays`.
|
|
117
|
+
Other settings: `agents`, `claude`, `json`, `openfeature`, `skill` (each a path, or `false`), `scan`, `scanIgnore`, `tests`, `coverageIgnore`, `changesets`, `reviewDays`.
|
|
118
|
+
|
|
119
|
+
The flag scan ignores comments and test files. List the flags runtime itself (the files that define the accessors and read by variable) in `scanIgnore`; setting it replaces the default test globs, so include those too.
|
|
118
120
|
|
|
119
121
|
The CLI loads TypeScript itself, so the registry needs no build step. Keep its imports to packages, with no path aliases.
|
|
120
122
|
|
|
@@ -265,6 +265,7 @@ var replaceAgentsBlock = (doc, block) => replaceBlock(doc, block, AGENTS_BLOCK_S
|
|
|
265
265
|
function toSkillMarkdown(options = {}) {
|
|
266
266
|
const source = options.source ?? "src/features.ts";
|
|
267
267
|
const command = options.command ?? "genesis features";
|
|
268
|
+
const outputs = options.outputs ?? ["the AGENTS.md block", "features.json", "this skill"];
|
|
268
269
|
return `---
|
|
269
270
|
name: features
|
|
270
271
|
description: 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.
|
|
@@ -274,8 +275,8 @@ description: Find, add, change and retire this repo's features in ${source}, and
|
|
|
274
275
|
|
|
275
276
|
# Features
|
|
276
277
|
|
|
277
|
-
\`${source}\` is the one list of what this product does. Running code imports it, and
|
|
278
|
-
|
|
278
|
+
\`${source}\` is the one list of what this product does. Running code imports it, and
|
|
279
|
+
\`${command} build\` generates the rest from it: ${outputs.join(", ")}.
|
|
279
280
|
|
|
280
281
|
## Find
|
|
281
282
|
- \`${command} find <term>\` searches ids, aliases, names, summaries and code paths. Run it before
|
|
@@ -314,5 +315,5 @@ other copy (the AGENTS.md block, JSON, the flags manifest, the admin page) is ge
|
|
|
314
315
|
}
|
|
315
316
|
|
|
316
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 };
|
|
317
|
-
//# sourceMappingURL=chunk-
|
|
318
|
-
//# sourceMappingURL=chunk-
|
|
318
|
+
//# sourceMappingURL=chunk-ZYWK7XPT.js.map
|
|
319
|
+
//# sourceMappingURL=chunk-ZYWK7XPT.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/model.ts","../src/generate.ts"],"names":[],"mappings":"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","file":"chunk-ZYWK7XPT.js","sourcesContent":["import { z } from \"zod\";\n\n/**\n * Where a feature is in its life. The order is the board's column order.\n *\n * @stability Beta\n */\nexport const FEATURE_STATUSES = [\"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/** 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}\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/** 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 })\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 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 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 if (problems.length) throw new FeatureRegistryError(problems);\n return Object.freeze(features);\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 * Features matching `term` in their id, aliases, name, summary, tagline,\n * category or code paths, best matches (id and name) first.\n *\n * @stability Beta\n */\nexport function findFeatures(features: Features, term: string, flags?: Flags): FeatureRecord[] {\n const needle = term.trim().toLowerCase();\n if (!needle) return [];\n const score = (r: FeatureRecord) => {\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.flags.some((f) => f.toLowerCase().includes(needle))) return 2;\n const rest = [r.summary, r.tagline, r.category, ...(r.links?.code ?? []), ...(r.aliases ?? [])];\n return rest.some((v) => v?.toLowerCase().includes(needle)) ? 3 : -1;\n };\n return toRecords(features, flags)\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\n- \\`${command} find <term>\\` searches ids, aliases, names, summaries and code paths. Run it before\n building anything new: extend the feature that already covers it rather than adding a second one.\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 - \\`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\\`.\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: planned, building, beta, live, deprecated, retired. \\`check\\` warns when a\n 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
|
@@ -70,10 +70,14 @@ declare const readAgentsBlock: (doc: string) => string | null;
|
|
|
70
70
|
declare const replaceAgentsBlock: (doc: string, block: string) => string;
|
|
71
71
|
/**
|
|
72
72
|
* The agent skill for working with the registry, written to
|
|
73
|
-
* `.claude/skills/features/SKILL.md` by `genesis features build`.
|
|
73
|
+
* `.claude/skills/features/SKILL.md` by `genesis features build`. `outputs`
|
|
74
|
+
* names what the build writes in this repo, so the skill never claims a file
|
|
75
|
+
* the repo turned off.
|
|
74
76
|
*
|
|
75
77
|
* @stability Beta
|
|
76
78
|
*/
|
|
77
|
-
declare function toSkillMarkdown(options?: GenerateOptions
|
|
79
|
+
declare function toSkillMarkdown(options?: GenerateOptions & {
|
|
80
|
+
outputs?: readonly string[];
|
|
81
|
+
}): string;
|
|
78
82
|
|
|
79
83
|
export { AGENTS_BLOCK_END, AGENTS_BLOCK_START, BrokenBlockError, FeatureRecord, Features, Flags, type GenerateOptions, MARKETING_BLOCK_END, MARKETING_BLOCK_START, OPENFEATURE_MANIFEST_SCHEMA, marketingRecords, readAgentsBlock, replaceAgentsBlock, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toSkillMarkdown };
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
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, replaceAgentsBlock, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toRecords, toSkillMarkdown } from './chunk-
|
|
1
|
+
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, replaceAgentsBlock, toAgentsMarkdown, toJson, toMarketingMarkdown, toOpenFeatureManifest, toRecords, toSkillMarkdown } from './chunk-ZYWK7XPT.js';
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
|
3
3
|
//# sourceMappingURL=index.js.map
|
package/dist/node.d.ts
CHANGED
|
@@ -39,6 +39,12 @@ interface FeatureProjectOptions {
|
|
|
39
39
|
flagAccessors?: readonly string[];
|
|
40
40
|
/** Code scanned for flag reads. Default `src`, `app` and `packages/*\/src`. */
|
|
41
41
|
scan?: readonly string[] | false;
|
|
42
|
+
/**
|
|
43
|
+
* Files the flag scan skips: the flags runtime that defines the accessors and
|
|
44
|
+
* reads by variable, and tests, which build keys on purpose. Default the test
|
|
45
|
+
* globs (`tests`).
|
|
46
|
+
*/
|
|
47
|
+
scanIgnore?: readonly string[];
|
|
42
48
|
/** Test files scanned for `@feat:<id>` tags. */
|
|
43
49
|
tests?: readonly string[] | false;
|
|
44
50
|
/** The changesets folder, scanned for `Features: <id>` lines. Default `.changeset`. */
|
|
@@ -93,11 +99,20 @@ interface FeatureCheckResult {
|
|
|
93
99
|
}
|
|
94
100
|
/** A glob (`*`, `**`, `?`, `{a,b}`) as a RegExp over `/`-separated relative paths. */
|
|
95
101
|
declare function globToRegExp(glob: string): RegExp;
|
|
102
|
+
/**
|
|
103
|
+
* `text` with its comments blanked to spaces (newlines kept), so a flag named
|
|
104
|
+
* in a comment isn't read as a flag read and line numbers stay right. Strings,
|
|
105
|
+
* regex literals and template text are left alone; a template's `${…}` is code.
|
|
106
|
+
* With `strings`, string and template-text contents are blanked too (quotes
|
|
107
|
+
* stay), so prose in a string ("…the release flag (off)") can't look like a call.
|
|
108
|
+
*/
|
|
109
|
+
declare function blankComments(text: string, strings?: boolean): string;
|
|
96
110
|
/**
|
|
97
111
|
* Flag reads in `text`: each key read through an accessor with a literal, and
|
|
98
|
-
* each read whose key isn't a literal (`dynamic`), as `path:line`.
|
|
112
|
+
* each read whose key isn't a literal (`dynamic`), as `path:line`. Comments
|
|
113
|
+
* don't count.
|
|
99
114
|
*/
|
|
100
|
-
declare function scanFlagReads(path: string,
|
|
115
|
+
declare function scanFlagReads(path: string, source: string, accessors?: readonly string[]): {
|
|
101
116
|
keys: {
|
|
102
117
|
key: string;
|
|
103
118
|
where: string;
|
|
@@ -137,4 +152,4 @@ declare function checkFeatureOutputs(options: FeatureProjectOptions): FeatureChe
|
|
|
137
152
|
*/
|
|
138
153
|
declare function summarizeCheck(result: FeatureCheckResult, features: Features): string;
|
|
139
154
|
|
|
140
|
-
export { type FeatureCheckResult, type FeatureEvidence, type FeaturePrEvidence, type FeatureProjectOptions, type PlannedButShipped, buildFeatureOutputs, checkFeatureOutputs, globToRegExp, scanFlagReads, summarizeCheck };
|
|
155
|
+
export { type FeatureCheckResult, type FeatureEvidence, type FeaturePrEvidence, type FeatureProjectOptions, type PlannedButShipped, blankComments, buildFeatureOutputs, checkFeatureOutputs, globToRegExp, scanFlagReads, summarizeCheck };
|
package/dist/node.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
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-ZYWK7XPT.js';
|
|
2
2
|
import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
|
|
3
3
|
import { join, dirname } from 'path';
|
|
4
4
|
|
|
@@ -63,14 +63,105 @@ function literalAt(text, i) {
|
|
|
63
63
|
if (quote === "`" && value.includes("${")) return null;
|
|
64
64
|
return value;
|
|
65
65
|
}
|
|
66
|
-
function
|
|
66
|
+
function blankComments(text, strings = false) {
|
|
67
|
+
return blankFrom(text, 0, false, strings).out;
|
|
68
|
+
}
|
|
69
|
+
var BEFORE_REGEX = new Set("(,=:[!&|?{};+-*%<>~^");
|
|
70
|
+
var REGEX_KEYWORDS = /(?:^|[^\w$.])(?:return|typeof|instanceof|in|new|delete|void|throw|case|do|else|yield|await)$/;
|
|
71
|
+
function blankFrom(text, i, inTemplate, strings = false) {
|
|
72
|
+
const keep = (chunk) => strings ? chunk.replace(/[^\n]/g, " ") : chunk;
|
|
73
|
+
let out = "";
|
|
74
|
+
let depth = 0;
|
|
75
|
+
while (i < text.length) {
|
|
76
|
+
const c = text[i];
|
|
77
|
+
const next = text[i + 1];
|
|
78
|
+
if (inTemplate && c === "}" && depth === 0) return { out, end: i };
|
|
79
|
+
if (c === "{") depth++;
|
|
80
|
+
else if (c === "}") depth--;
|
|
81
|
+
if (c === "/" && next === "/") {
|
|
82
|
+
const end = text.indexOf("\n", i);
|
|
83
|
+
const stop = end === -1 ? text.length : end;
|
|
84
|
+
out += " ".repeat(stop - i);
|
|
85
|
+
i = stop;
|
|
86
|
+
} else if (c === "/" && next === "*") {
|
|
87
|
+
const end = text.indexOf("*/", i + 2);
|
|
88
|
+
const stop = end === -1 ? text.length : end + 2;
|
|
89
|
+
out += text.slice(i, stop).replace(/[^\n]/g, " ");
|
|
90
|
+
i = stop;
|
|
91
|
+
} else if (c === "/" && next !== ">" && startsRegex(out)) {
|
|
92
|
+
let j = i + 1;
|
|
93
|
+
let inClass = false;
|
|
94
|
+
while (j < text.length && text[j] !== "\n") {
|
|
95
|
+
const r = text[j];
|
|
96
|
+
if (r === "\\") j += 2;
|
|
97
|
+
else {
|
|
98
|
+
if (r === "[") inClass = true;
|
|
99
|
+
else if (r === "]") inClass = false;
|
|
100
|
+
else if (r === "/" && !inClass) break;
|
|
101
|
+
j++;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
if (text[j] !== "/") {
|
|
105
|
+
out += c;
|
|
106
|
+
i++;
|
|
107
|
+
continue;
|
|
108
|
+
}
|
|
109
|
+
out += text.slice(i, j + 1);
|
|
110
|
+
i = j + 1;
|
|
111
|
+
} else if (c === "`") {
|
|
112
|
+
out += c;
|
|
113
|
+
let j = i + 1;
|
|
114
|
+
while (j < text.length && text[j] !== "`") {
|
|
115
|
+
if (text[j] === "\\") {
|
|
116
|
+
out += keep(text.slice(j, j + 2));
|
|
117
|
+
j += 2;
|
|
118
|
+
} else if (text[j] === "$" && text[j + 1] === "{") {
|
|
119
|
+
out += "${";
|
|
120
|
+
const inner = blankFrom(text, j + 2, true, strings);
|
|
121
|
+
out += inner.out;
|
|
122
|
+
j = inner.end;
|
|
123
|
+
if (j < text.length) out += text[j];
|
|
124
|
+
j++;
|
|
125
|
+
} else {
|
|
126
|
+
out += keep(text[j]);
|
|
127
|
+
j++;
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
if (j < text.length) out += "`";
|
|
131
|
+
i = j + 1;
|
|
132
|
+
} else if (c === '"' || c === "'") {
|
|
133
|
+
let j = i + 1;
|
|
134
|
+
while (j < text.length && text[j] !== c && text[j] !== "\n") j += text[j] === "\\" ? 2 : 1;
|
|
135
|
+
if (text[j] === c) {
|
|
136
|
+
out += c + keep(text.slice(i + 1, j)) + c;
|
|
137
|
+
i = j + 1;
|
|
138
|
+
} else {
|
|
139
|
+
out += c;
|
|
140
|
+
i++;
|
|
141
|
+
}
|
|
142
|
+
} else {
|
|
143
|
+
out += c;
|
|
144
|
+
i++;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
return { out, end: i };
|
|
148
|
+
}
|
|
149
|
+
function startsRegex(before) {
|
|
150
|
+
const trimmed = before.replace(/\s+$/, "");
|
|
151
|
+
if (trimmed === "") return true;
|
|
152
|
+
if (before.endsWith("<")) return false;
|
|
153
|
+
return BEFORE_REGEX.has(trimmed[trimmed.length - 1]) || REGEX_KEYWORDS.test(trimmed);
|
|
154
|
+
}
|
|
155
|
+
function scanFlagReads(path, source, accessors = DEFAULT_ACCESSORS) {
|
|
156
|
+
const text = blankComments(source);
|
|
157
|
+
const code = blankComments(source, true);
|
|
67
158
|
const keys = [];
|
|
68
159
|
const dynamic = [];
|
|
69
160
|
for (const accessor of accessors) {
|
|
70
161
|
const jsx = /^<(\w[\w.]*)\s+(\w+)>$/.exec(accessor);
|
|
71
162
|
if (jsx) {
|
|
72
163
|
const re2 = new RegExp(`<${jsx[1].replace(/\./g, "\\.")}\\b[^>]*?\\b${jsx[2]}\\s*=\\s*`, "g");
|
|
73
|
-
for (const m of
|
|
164
|
+
for (const m of code.matchAll(re2)) {
|
|
74
165
|
let i = m.index + m[0].length;
|
|
75
166
|
if (text[i] === "{") i = text.slice(i + 1).search(/\S/) + i + 1;
|
|
76
167
|
const key = literalAt(text, i);
|
|
@@ -80,7 +171,7 @@ function scanFlagReads(path, text, accessors = DEFAULT_ACCESSORS) {
|
|
|
80
171
|
continue;
|
|
81
172
|
}
|
|
82
173
|
const re = new RegExp(`(?<![\\w$.])(function\\s+)?${accessor.replace(/\$/g, "\\$")}\\s*(?:<[^>()]*>)?\\s*\\(\\s*`, "g");
|
|
83
|
-
for (const m of
|
|
174
|
+
for (const m of code.matchAll(re)) {
|
|
84
175
|
if (m[1]) continue;
|
|
85
176
|
const i = m.index + m[0].length;
|
|
86
177
|
if (text[i] === ")") continue;
|
|
@@ -127,7 +218,15 @@ function outputs(options) {
|
|
|
127
218
|
}
|
|
128
219
|
if (json) list.push({ path: json, ...whole(toJson(features, flags, { source })) });
|
|
129
220
|
if (openfeature && flags && Object.keys(flags).length) list.push({ path: openfeature, ...whole(toOpenFeatureManifest(flags, features)) });
|
|
130
|
-
|
|
221
|
+
const writesFlags = Boolean(openfeature && flags && Object.keys(flags).length);
|
|
222
|
+
const generated = [
|
|
223
|
+
...agents ? [`the ${agents} block`] : [],
|
|
224
|
+
...json ? [`\`${json}\``] : [],
|
|
225
|
+
...writesFlags ? [`\`${openfeature}\` (the OpenFeature flag manifest)`] : [],
|
|
226
|
+
...options.marketing ? [`the ${options.marketing} Features section`] : [],
|
|
227
|
+
...skill ? ["this skill"] : []
|
|
228
|
+
];
|
|
229
|
+
if (skill) list.push({ path: skill, ...whole(toSkillMarkdown({ source, command, outputs: generated })) });
|
|
131
230
|
if (options.marketing) {
|
|
132
231
|
const block = toMarketingMarkdown(features, { heading: options.marketingHeading, source });
|
|
133
232
|
list.push({
|
|
@@ -233,8 +332,9 @@ function checkFeatureOutputs(options) {
|
|
|
233
332
|
for (const name of expired) errors.push(`${name} expired on ${flags[name].expires}: remove its code path, then the flag`);
|
|
234
333
|
if (options.scan !== false) {
|
|
235
334
|
const inScan = matcher(options.scan ?? DEFAULT_SCAN);
|
|
335
|
+
const skipped = matcher(options.scanIgnore ?? (options.tests || DEFAULT_TESTS));
|
|
236
336
|
const used = /* @__PURE__ */ new Map();
|
|
237
|
-
for (const path of files.filter((p) => inScan(p) && !p.endsWith(".d.ts"))) {
|
|
337
|
+
for (const path of files.filter((p) => inScan(p) && !skipped(p) && !p.endsWith(".d.ts"))) {
|
|
238
338
|
const { keys, dynamic } = scanFlagReads(path, readFileSync(join(root, path), "utf8"), options.flagAccessors ?? DEFAULT_ACCESSORS);
|
|
239
339
|
for (const where of dynamic) errors.push(`${where}: a flag read with a computed key. Use a literal key, so the read can be checked`);
|
|
240
340
|
for (const { key, where } of keys) {
|
|
@@ -332,6 +432,6 @@ function summarizeCheck(result, features) {
|
|
|
332
432
|
return lines.join("\n");
|
|
333
433
|
}
|
|
334
434
|
|
|
335
|
-
export { buildFeatureOutputs, checkFeatureOutputs, globToRegExp, scanFlagReads, summarizeCheck };
|
|
435
|
+
export { blankComments, buildFeatureOutputs, checkFeatureOutputs, globToRegExp, scanFlagReads, summarizeCheck };
|
|
336
436
|
//# sourceMappingURL=node.js.map
|
|
337
437
|
//# sourceMappingURL=node.js.map
|
package/dist/node.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/node.ts"],"names":["re"],"mappings":"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","file":"node.js","sourcesContent":["import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport {\n BrokenBlockError,\n MARKETING_BLOCK_END,\n MARKETING_BLOCK_START,\n readAgentsBlock,\n readBlock,\n replaceAgentsBlock,\n replaceBlock,\n toAgentsMarkdown,\n toJson,\n toMarketingMarkdown,\n toOpenFeatureManifest,\n toSkillMarkdown,\n} from \"./generate\";\nimport { expiredFlags, type Features, type Flags } from \"./model\";\n\n/**\n * Where a repo keeps its registry's outputs and what `check` scans. Every\n * path is relative to `root`; `false` turns an output or a scan off. The CLI\n * reads these from `package.json` → `\"genesisFeatures\"`, and its options win.\n *\n * @stability Beta\n */\nexport interface FeatureProjectOptions {\n /** The repository root. */\n root: string;\n features: Features;\n flags?: Flags;\n /** The registry file, named in generated output. Default `src/features.ts`. */\n source?: string;\n /** How people run the CLI here, named in generated output. Default `genesis features`. */\n command?: string;\n /** The AGENTS.md that holds the pointer block. Default `AGENTS.md`. */\n agents?: string | false;\n /** The CLAUDE.md that must import AGENTS.md (`@AGENTS.md`). Default `CLAUDE.md`. */\n claude?: string | false;\n /** The JSON copy, which is also the record of every id ever used. Default `features.json`. */\n json?: string | false;\n /** The OpenFeature flag manifest, written when there are flags. Default `flags.json`. */\n openfeature?: string | false;\n /** The agent skill. Default `.claude/skills/features/SKILL.md`. */\n skill?: string | false;\n /** A file to keep the marketing block in (e.g. README.md). Default none. */\n marketing?: string | false;\n /** The marketing block's heading. Default `Features`. */\n marketingHeading?: string;\n /**\n * How code reads a flag: a function name (`useFlag`, read as its first\n * argument) or a JSX attribute (`<Flag name>`). Default `useFlag`, `getFlag`\n * and `<Flag name>`.\n */\n flagAccessors?: readonly string[];\n /** Code scanned for flag reads. Default `src`, `app` and `packages/*\\/src`. */\n scan?: readonly string[] | false;\n /** Test files scanned for `@feat:<id>` tags. */\n tests?: readonly string[] | false;\n /** The changesets folder, scanned for `Features: <id>` lines. Default `.changeset`. */\n changesets?: string | false;\n /** The PR's labels, checked for `feature:<id>`. */\n labels?: readonly string[];\n /** Route and server-function files every one of which some `links.code` should cover. */\n coverage?: readonly string[] | false;\n coverageIgnore?: readonly string[];\n /** Warn when `reviewedAt` is older than this many days. Default 90. */\n reviewDays?: number;\n /** `YYYY-MM-DD`. Default today (UTC). */\n today?: string;\n /**\n * Shipped work gathered elsewhere (the CLI's `--prs` reads it with `gh`).\n * A planned feature with any of it gets a warning, as do changesets that\n * name it.\n */\n evidence?: FeatureEvidence;\n}\n\n/** A merged PR labelled `feature:<id>`. @stability Beta */\nexport interface FeaturePrEvidence {\n number: number;\n title: string;\n}\n\n/** @stability Beta */\nexport interface FeatureEvidence {\n /** Merged PRs by the feature id (or alias) on their `feature:<id>` label. */\n prs?: Record<string, readonly FeaturePrEvidence[]>;\n}\n\n/** A feature still marked planned that already has shipped work tagged with it. @stability Beta */\nexport interface PlannedButShipped {\n id: string;\n /** Changeset files with a `Features: <id>` line. */\n changesets: string[];\n prs: FeaturePrEvidence[];\n}\n\n/** @stability Beta */\nexport interface FeatureCheckResult {\n ok: boolean;\n /** Hard failures: stale generated output, missing code paths, flag rules, removed ids, bad tags, no `@AGENTS.md`. */\n errors: string[];\n /** Everything else: reviews due, untested live features, uncovered routes, missing docs. */\n warnings: string[];\n /** Generated files that differ from what the generator makes now. */\n stale: string[];\n expiredFlags: string[];\n /** Building features with someone on them: `[id, claimedBy]`. */\n claims: [string, string][];\n /** Planned features with shipped work; each is also a warning. */\n plannedButShipped: PlannedButShipped[];\n}\n\nconst CODE = \"{ts,tsx,js,jsx,mjs,cjs}\";\nconst DEFAULT_SCAN = [`src/**/*.${CODE}`, `app/**/*.${CODE}`, `packages/*/src/**/*.${CODE}`];\nconst DEFAULT_TESTS = [`**/*.{test,spec}.${CODE}`, \"**/__tests__/**/*\", \"supabase/tests/**/*.sql\"];\nconst DEFAULT_COVERAGE = [`src/routes/**/*.${CODE}`, `app/routes/**/*.${CODE}`, \"**/*.functions.ts\"];\nconst DEFAULT_COVERAGE_IGNORE = [\"**/routeTree.gen.ts\", \"**/__root.tsx\", \"**/*.d.ts\"];\nconst DEFAULT_ACCESSORS = [\"useFlag\", \"getFlag\", \"<Flag name>\"];\nconst SKIP_DIRS = new Set([\"node_modules\", \"dist\", \"build\", \"coverage\", \"out\", \"storybook-static\"]);\n\n/** A file's text with CRLF line endings read as LF, so a Windows checkout isn't \"stale\" forever. */\nfunction read(file: string): string | null {\n return existsSync(file) ? readFileSync(file, \"utf8\").replace(/\\r\\n/g, \"\\n\") : null;\n}\n\n/** A glob (`*`, `**`, `?`, `{a,b}`) as a RegExp over `/`-separated relative paths. */\nexport function globToRegExp(glob: string): RegExp {\n let out = \"\";\n for (let i = 0; i < glob.length; i++) {\n const c = glob[i]!;\n if (c === \"*\" && glob[i + 1] === \"*\") {\n const slash = glob[i + 2] === \"/\";\n out += slash ? \"(?:.*/)?\" : \".*\";\n i += slash ? 2 : 1;\n } else if (c === \"*\") out += \"[^/]*\";\n else if (c === \"?\") out += \"[^/]\";\n else if (c === \"{\") {\n const close = glob.indexOf(\"}\", i);\n out += `(?:${glob.slice(i + 1, close).split(\",\").map((s) => s.replace(/[.+^$()|[\\]\\\\]/g, \"\\\\$&\")).join(\"|\")})`;\n i = close;\n } else out += c.replace(/[.+^$()|[\\]\\\\]/g, \"\\\\$&\");\n }\n return new RegExp(`^${out}$`);\n}\n\n/** Every file under `root`, skipping dot-folders, node_modules and build output. */\nfunction listFiles(root: string): string[] {\n const out: string[] = [];\n const walk = (rel: string) => {\n let entries;\n try {\n entries = readdirSync(join(root, rel), { withFileTypes: true });\n } catch {\n return;\n }\n for (const entry of entries) {\n const path = rel ? `${rel}/${entry.name}` : entry.name;\n if (entry.isDirectory()) {\n if (!entry.name.startsWith(\".\") && !SKIP_DIRS.has(entry.name)) walk(path);\n } else if (entry.isFile()) out.push(path);\n }\n };\n walk(\"\");\n return out;\n}\n\nfunction matcher(globs: readonly string[]) {\n const res = globs.map(globToRegExp);\n return (path: string) => res.some((re) => re.test(path));\n}\n\n/** A position in a file, as `path:line`. */\nconst at = (path: string, text: string, index: number) => `${path}:${text.slice(0, index).split(\"\\n\").length}`;\n\n/** The string literal starting at `text[i]`, or null when the expression there isn't one. */\nfunction literalAt(text: string, i: number): string | null {\n const quote = text[i];\n if (quote !== '\"' && quote !== \"'\" && quote !== \"`\") return null;\n const end = text.indexOf(quote, i + 1);\n if (end === -1) return null;\n const value = text.slice(i + 1, end);\n if (quote === \"`\" && value.includes(\"${\")) return null;\n return value;\n}\n\n/**\n * Flag reads in `text`: each key read through an accessor with a literal, and\n * each read whose key isn't a literal (`dynamic`), as `path:line`.\n */\nexport function scanFlagReads(path: string, text: string, accessors: readonly string[] = DEFAULT_ACCESSORS) {\n const keys: { key: string; where: string }[] = [];\n const dynamic: string[] = [];\n for (const accessor of accessors) {\n const jsx = /^<(\\w[\\w.]*)\\s+(\\w+)>$/.exec(accessor);\n if (jsx) {\n const re = new RegExp(`<${jsx[1]!.replace(/\\./g, \"\\\\.\")}\\\\b[^>]*?\\\\b${jsx[2]}\\\\s*=\\\\s*`, \"g\");\n for (const m of text.matchAll(re)) {\n let i = m.index! + m[0].length;\n if (text[i] === \"{\") i = text.slice(i + 1).search(/\\S/) + i + 1;\n const key = literalAt(text, i);\n if (key === null) dynamic.push(at(path, text, m.index!));\n else keys.push({ key, where: at(path, text, m.index!) });\n }\n continue;\n }\n const re = new RegExp(`(?<![\\\\w$.])(function\\\\s+)?${accessor.replace(/\\$/g, \"\\\\$\")}\\\\s*(?:<[^>()]*>)?\\\\s*\\\\(\\\\s*`, \"g\");\n for (const m of text.matchAll(re)) {\n if (m[1]) continue; // its own definition\n const i = m.index! + m[0].length;\n if (text[i] === \")\") continue;\n const key = literalAt(text, i);\n if (key !== null) keys.push({ key, where: at(path, text, m.index!) });\n // `useFlag(key: K)` in a type or a signature declares the accessor; it doesn't read a flag.\n else if (!/^[\\w$]+\\??\\s*:/.test(text.slice(i))) dynamic.push(at(path, text, m.index!));\n }\n }\n return { keys, dynamic };\n}\n\nconst ids = (features: Features) => new Set(Object.entries(features).flatMap(([id, f]) => [id, ...(f.aliases ?? [])]));\n\n/** Ids recorded in the committed JSON that the registry no longer has, as an id or an alias. */\nfunction removedIds(options: FeatureProjectOptions): string[] {\n const json = options.json === undefined ? \"features.json\" : options.json;\n if (!json) return [];\n const doc = read(join(options.root, json));\n if (!doc) return [];\n let previous: string[];\n try {\n previous = (JSON.parse(doc) as { features?: { id: string; aliases?: string[] }[] }).features?.flatMap((f) => [f.id, ...(f.aliases ?? [])]) ?? [];\n } catch {\n return [];\n }\n const now = ids(options.features);\n return previous.filter((id) => !now.has(id));\n}\n\n/** Each id and alias, mapped to its feature's id. */\nconst canonical = (features: Features) =>\n new Map(Object.entries(features).flatMap(([id, f]) => [id, ...(f.aliases ?? [])].map((name) => [name, id] as const)));\n\n/** \"a\", \"a and b\", \"a, b and c\". */\nconst and = (items: string[]) => (items.length < 2 ? items.join(\"\") : `${items.slice(0, -1).join(\", \")} and ${items.at(-1)}`);\n\nconst removedMessage = (id: string) =>\n `the feature id \"${id}\" was removed. Ids are permanent: keep the entry with status \"retired\", or list \"${id}\" in the new entry's aliases`;\n\n/** Every generated file: its path, and its content given what's on disk now. */\nfunction outputs(options: FeatureProjectOptions): { path: string; next: (current: string | null) => string; same: (current: string | null, next: string) => boolean }[] {\n const { features, flags, source, command } = options;\n const agents = options.agents === undefined ? \"AGENTS.md\" : options.agents;\n const json = options.json === undefined ? \"features.json\" : options.json;\n const openfeature = options.openfeature === undefined ? \"flags.json\" : options.openfeature;\n const skill = options.skill === undefined ? \".claude/skills/features/SKILL.md\" : options.skill;\n const whole = (content: string) => ({ next: () => content, same: (current: string | null, next: string) => current === next });\n const list = [];\n if (agents) {\n const block = toAgentsMarkdown(features, flags, { source, command, skill });\n list.push({\n path: agents,\n next: (current: string | null) => replaceAgentsBlock(current ?? \"\", block),\n same: (current: string | null) => current !== null && readAgentsBlock(current) === block,\n });\n }\n if (json) list.push({ path: json, ...whole(toJson(features, flags, { source })) });\n if (openfeature && flags && Object.keys(flags).length) list.push({ path: openfeature, ...whole(toOpenFeatureManifest(flags, features)) });\n if (skill) list.push({ path: skill, ...whole(toSkillMarkdown({ source, command })) });\n if (options.marketing) {\n const block = toMarketingMarkdown(features, { heading: options.marketingHeading, source });\n list.push({\n path: options.marketing,\n next: (current: string | null) => replaceBlock(current ?? \"\", block, MARKETING_BLOCK_START, MARKETING_BLOCK_END),\n same: (current: string | null) => current !== null && readBlock(current, MARKETING_BLOCK_START, MARKETING_BLOCK_END) === block,\n });\n }\n return list;\n}\n\nfunction claudeImport(options: FeatureProjectOptions): { path: string; line: string } | null {\n const agents = options.agents === undefined ? \"AGENTS.md\" : options.agents;\n const claude = options.claude === undefined ? \"CLAUDE.md\" : options.claude;\n return agents && claude ? { path: claude, line: `@${agents}` } : null;\n}\n\nconst hasImport = (doc: string | null, line: string) =>\n doc !== null && new RegExp(`^${line.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\\\s*$`, \"m\").test(doc);\n\n/**\n * Writes every generated output (the AGENTS.md block, the JSON, the flag\n * manifest, the skill, the marketing block) and adds `@AGENTS.md` to\n * CLAUDE.md when it's missing. Refuses, writing nothing, when an id recorded\n * in the JSON has disappeared. Returns the paths it changed.\n *\n * @stability Beta\n */\nexport function buildFeatureOutputs(options: FeatureProjectOptions): string[] {\n const removed = removedIds(options);\n if (removed.length) throw new Error(removed.map(removedMessage).join(\"\\n\"));\n const changed: string[] = [];\n const write = (rel: string, next: string) => {\n const file = join(options.root, rel);\n mkdirSync(dirname(file), { recursive: true });\n writeFileSync(file, next);\n changed.push(rel);\n };\n for (const output of outputs(options)) {\n const current = read(join(options.root, output.path));\n let next: string;\n try {\n next = output.next(current);\n } catch (error) {\n if (error instanceof BrokenBlockError) throw new Error(`${output.path}: ${error.message}`);\n throw error;\n }\n if (!output.same(current, next)) write(output.path, next);\n }\n const claude = claudeImport(options);\n if (claude) {\n const current = read(join(options.root, claude.path));\n if (!hasImport(current, claude.line)) {\n const base = current === null || current === \"\" ? \"\" : current.endsWith(\"\\n\") ? `${current}\\n` : `${current}\\n\\n`;\n write(claude.path, `${base}${claude.line}\\n`);\n }\n }\n return changed;\n}\n\n/**\n * Checks the registry against the repo. Errors (exit 1): generated output that\n * is stale, `links.code` paths that don't exist, the flag rules (a permission\n * flag, an expired flag, a dynamic key, a key read but not defined or defined\n * but never read, a missing runbook), an id that disappeared, an unknown id in\n * a test, changeset or PR tag, and a CLAUDE.md without `@AGENTS.md`.\n * Warnings: reviews due, live features without tagged tests, planned features\n * with shipped work (changesets, and `evidence.prs`), route and\n * server-function files no feature covers, missing docs.\n *\n * It only ever compares generated output with the generator, never two\n * hand-written files.\n *\n * @stability Beta\n */\nexport function checkFeatureOutputs(options: FeatureProjectOptions): FeatureCheckResult {\n const { root, features, flags } = options;\n const today = options.today ?? new Date().toISOString().slice(0, 10);\n const errors: string[] = [];\n const warnings: string[] = [];\n const stale: string[] = [];\n const known = ids(features);\n\n for (const output of outputs(options)) {\n const current = read(join(root, output.path));\n let same: boolean;\n try {\n same = output.same(current, output.next(current));\n } catch (error) {\n if (!(error instanceof BrokenBlockError)) throw error;\n errors.push(`${output.path}: ${error.message}`);\n continue;\n }\n if (!same) {\n stale.push(output.path);\n errors.push(`${output.path} is stale. Run \\`${options.command ?? \"genesis features\"} build\\` and commit the result.`);\n }\n }\n const claude = claudeImport(options);\n if (claude && !hasImport(read(join(root, claude.path)), claude.line)) {\n errors.push(`${claude.path} must import the agent notes with a line \\`${claude.line}\\` (\\`build\\` adds it).`);\n }\n for (const id of removedIds(options)) errors.push(removedMessage(id));\n\n const reviewCutoff = new Date(Date.parse(today) - (options.reviewDays ?? 90) * 86_400_000).toISOString().slice(0, 10);\n const claims: [string, string][] = [];\n for (const [id, def] of Object.entries(features)) {\n for (const path of def.links?.code ?? []) {\n if (!existsSync(join(root, path))) errors.push(`${id}.links.code: ${path} doesn't exist`);\n }\n for (const path of def.links?.docs ?? []) {\n if (!/^https?:\\/\\//.test(path) && !existsSync(join(root, path))) warnings.push(`${id}.links.docs: ${path} doesn't exist`);\n }\n if (def.claimedBy) claims.push([id, def.claimedBy]);\n if (def.status !== \"planned\" && def.status !== \"retired\") {\n if (!def.reviewedAt) warnings.push(`${id}: never reviewed (set reviewedAt)`);\n else if (def.reviewedAt < reviewCutoff) warnings.push(`${id}: last reviewed ${def.reviewedAt}, over ${options.reviewDays ?? 90} days ago`);\n }\n }\n\n const files = listFiles(root);\n const expired = expiredFlags(flags, today);\n if (flags) {\n for (const [name, flag] of Object.entries(flags)) {\n if (flag.kind === \"permission\") errors.push(`${name}: a permission flag. Paid or role access belongs in the feature's \\`access\\` (entitlements), not a flag`);\n if (flag.runbook && !/^https?:\\/\\//.test(flag.runbook) && !existsSync(join(root, flag.runbook))) {\n errors.push(`${name}.runbook: ${flag.runbook} doesn't exist`);\n }\n }\n for (const name of expired) errors.push(`${name} expired on ${flags[name]!.expires}: remove its code path, then the flag`);\n if (options.scan !== false) {\n const inScan = matcher(options.scan ?? DEFAULT_SCAN);\n const used = new Map<string, string>();\n for (const path of files.filter((p) => inScan(p) && !p.endsWith(\".d.ts\"))) {\n const { keys, dynamic } = scanFlagReads(path, readFileSync(join(root, path), \"utf8\"), options.flagAccessors ?? DEFAULT_ACCESSORS);\n for (const where of dynamic) errors.push(`${where}: a flag read with a computed key. Use a literal key, so the read can be checked`);\n for (const { key, where } of keys) {\n if (!Object.hasOwn(flags, key)) errors.push(`${where}: the flag \"${key}\" is read but not defined`);\n if (!used.has(key)) used.set(key, where);\n }\n }\n for (const name of Object.keys(flags)) {\n if (!used.has(name)) errors.push(`${name}: defined but never read. Remove it, or read it through the flag accessor`);\n }\n }\n }\n\n const tagged = new Set<string>();\n if (options.tests !== false) {\n const inTests = matcher(options.tests ?? DEFAULT_TESTS);\n for (const path of files.filter(inTests)) {\n const text = readFileSync(join(root, path), \"utf8\");\n for (const m of text.matchAll(/@feat:([a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*)/g)) {\n if (!known.has(m[1]!)) errors.push(`${at(path, text, m.index!)}: @feat:${m[1]} is not a feature`);\n else tagged.add(m[1]!);\n }\n }\n for (const [id, def] of Object.entries(features)) {\n const names = [id, ...(def.aliases ?? [])];\n if (def.status === \"live\" && !names.some((n) => tagged.has(n))) warnings.push(`${id}: live, but no test is tagged @feat:${id}`);\n }\n }\n\n const idOf = canonical(features);\n const shippedIn = new Map<string, { changesets: string[]; prs: FeaturePrEvidence[] }>();\n const shipped = (name: string) => {\n const id = idOf.get(name)!;\n if (!shippedIn.has(id)) shippedIn.set(id, { changesets: [], prs: [] });\n return shippedIn.get(id)!;\n };\n const changesets = options.changesets === undefined ? \".changeset\" : options.changesets;\n if (changesets) {\n for (const path of listChangesets(root, changesets)) {\n // The body only, so frontmatter never counts; CRLF read as LF.\n const text = read(join(root, path))!.replace(/^---\\n[\\s\\S]*?\\n---\\n/, \"\");\n for (const m of text.matchAll(/^features:[ \\t]*\\[?([^\\]\\n]*)\\]?[ \\t]*$/gim)) {\n for (const id of m[1]!.split(/[\\s,]+/).filter(Boolean)) {\n if (!known.has(id)) errors.push(`${path}: Features: ${id} is not a feature`);\n else if (!shipped(id).changesets.includes(path)) shipped(id).changesets.push(path);\n }\n }\n }\n }\n for (const [name, prs] of Object.entries(options.evidence?.prs ?? {})) {\n if (!known.has(name)) continue;\n const list = shipped(name).prs;\n for (const pr of prs) if (!list.some((p) => p.number === pr.number)) list.push(pr);\n }\n const plannedButShipped: PlannedButShipped[] = [];\n for (const [id, def] of Object.entries(features)) {\n const found = shippedIn.get(id);\n if (def.status !== \"planned\" || !found || (!found.changesets.length && !found.prs.length)) continue;\n const prs = [...found.prs].sort((a, b) => a.number - b.number);\n plannedButShipped.push({ id, changesets: found.changesets, prs });\n warnings.push(`${id} is still planned, but ${and([...found.changesets, ...prs.map((p) => `PR #${p.number}`)])} shipped work for it`);\n }\n for (const label of options.labels ?? []) {\n const id = /^feature:(.+)$/.exec(label.trim())?.[1];\n if (id && !known.has(id)) errors.push(`PR label ${label}: ${id} is not a feature`);\n }\n\n if (options.coverage !== false) {\n const inCoverage = matcher(options.coverage ?? DEFAULT_COVERAGE);\n const ignored = matcher(options.coverageIgnore ?? DEFAULT_COVERAGE_IGNORE);\n const covered = Object.values(features).flatMap((f) => f.links?.code ?? []).map((p) => p.replace(/\\/+$/, \"\"));\n for (const path of files.filter((p) => inCoverage(p) && !ignored(p))) {\n if (!covered.some((c) => path === c || path.startsWith(`${c}/`))) warnings.push(`${path}: no feature's links.code covers it`);\n }\n }\n\n return { ok: errors.length === 0, errors, warnings, stale, expiredFlags: expired, claims, plannedButShipped };\n}\n\nfunction listChangesets(root: string, dir: string): string[] {\n try {\n return readdirSync(join(root, dir))\n .filter((f) => f.endsWith(\".md\") && f.toLowerCase() !== \"readme.md\")\n .map((f) => `${dir}/${f}`);\n } catch {\n return [];\n }\n}\n\n/**\n * A few lines for a session's start: counts, stale output, expired flags,\n * planned features with shipped work and open claims. Meant for a SessionStart hook (`genesis features check --summary`).\n *\n * @stability Beta\n */\nexport function summarizeCheck(result: FeatureCheckResult, features: Features): string {\n const total = Object.keys(features).length;\n const lines = [\n `Features: ${total} in the registry; ${result.errors.length} error${result.errors.length === 1 ? \"\" : \"s\"}, ${result.warnings.length} warning${result.warnings.length === 1 ? \"\" : \"s\"}.`,\n ];\n if (result.stale.length) lines.push(`- Stale generated files: ${result.stale.join(\", \")}. Run the features build.`);\n if (result.expiredFlags.length) lines.push(`- Expired flags: ${result.expiredFlags.join(\", \")}. Remove the code path, then the flag.`);\n if (result.plannedButShipped.length) {\n const n = result.plannedButShipped.length;\n lines.push(`- ${n} planned feature${n === 1 ? \" has\" : \"s have\"} shipped work: ${result.plannedButShipped.map((s) => s.id).join(\", \")}. Move ${n === 1 ? \"its\" : \"their\"} status on.`);\n }\n if (result.claims.length) lines.push(`- Being built: ${result.claims.map(([id, by]) => `${id} (${by})`).join(\", \")}.`);\n const other = result.errors.length - result.stale.length - result.expiredFlags.length;\n if (other > 0) lines.push(`- ${other} other error${other === 1 ? \"\" : \"s\"}: run the features check for details.`);\n return lines.join(\"\\n\");\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/node.ts"],"names":["re"],"mappings":"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","file":"node.js","sourcesContent":["import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport {\n BrokenBlockError,\n MARKETING_BLOCK_END,\n MARKETING_BLOCK_START,\n readAgentsBlock,\n readBlock,\n replaceAgentsBlock,\n replaceBlock,\n toAgentsMarkdown,\n toJson,\n toMarketingMarkdown,\n toOpenFeatureManifest,\n toSkillMarkdown,\n} from \"./generate\";\nimport { expiredFlags, type Features, type Flags } from \"./model\";\n\n/**\n * Where a repo keeps its registry's outputs and what `check` scans. Every\n * path is relative to `root`; `false` turns an output or a scan off. The CLI\n * reads these from `package.json` → `\"genesisFeatures\"`, and its options win.\n *\n * @stability Beta\n */\nexport interface FeatureProjectOptions {\n /** The repository root. */\n root: string;\n features: Features;\n flags?: Flags;\n /** The registry file, named in generated output. Default `src/features.ts`. */\n source?: string;\n /** How people run the CLI here, named in generated output. Default `genesis features`. */\n command?: string;\n /** The AGENTS.md that holds the pointer block. Default `AGENTS.md`. */\n agents?: string | false;\n /** The CLAUDE.md that must import AGENTS.md (`@AGENTS.md`). Default `CLAUDE.md`. */\n claude?: string | false;\n /** The JSON copy, which is also the record of every id ever used. Default `features.json`. */\n json?: string | false;\n /** The OpenFeature flag manifest, written when there are flags. Default `flags.json`. */\n openfeature?: string | false;\n /** The agent skill. Default `.claude/skills/features/SKILL.md`. */\n skill?: string | false;\n /** A file to keep the marketing block in (e.g. README.md). Default none. */\n marketing?: string | false;\n /** The marketing block's heading. Default `Features`. */\n marketingHeading?: string;\n /**\n * How code reads a flag: a function name (`useFlag`, read as its first\n * argument) or a JSX attribute (`<Flag name>`). Default `useFlag`, `getFlag`\n * and `<Flag name>`.\n */\n flagAccessors?: readonly string[];\n /** Code scanned for flag reads. Default `src`, `app` and `packages/*\\/src`. */\n scan?: readonly string[] | false;\n /**\n * Files the flag scan skips: the flags runtime that defines the accessors and\n * reads by variable, and tests, which build keys on purpose. Default the test\n * globs (`tests`).\n */\n scanIgnore?: readonly string[];\n /** Test files scanned for `@feat:<id>` tags. */\n tests?: readonly string[] | false;\n /** The changesets folder, scanned for `Features: <id>` lines. Default `.changeset`. */\n changesets?: string | false;\n /** The PR's labels, checked for `feature:<id>`. */\n labels?: readonly string[];\n /** Route and server-function files every one of which some `links.code` should cover. */\n coverage?: readonly string[] | false;\n coverageIgnore?: readonly string[];\n /** Warn when `reviewedAt` is older than this many days. Default 90. */\n reviewDays?: number;\n /** `YYYY-MM-DD`. Default today (UTC). */\n today?: string;\n /**\n * Shipped work gathered elsewhere (the CLI's `--prs` reads it with `gh`).\n * A planned feature with any of it gets a warning, as do changesets that\n * name it.\n */\n evidence?: FeatureEvidence;\n}\n\n/** A merged PR labelled `feature:<id>`. @stability Beta */\nexport interface FeaturePrEvidence {\n number: number;\n title: string;\n}\n\n/** @stability Beta */\nexport interface FeatureEvidence {\n /** Merged PRs by the feature id (or alias) on their `feature:<id>` label. */\n prs?: Record<string, readonly FeaturePrEvidence[]>;\n}\n\n/** A feature still marked planned that already has shipped work tagged with it. @stability Beta */\nexport interface PlannedButShipped {\n id: string;\n /** Changeset files with a `Features: <id>` line. */\n changesets: string[];\n prs: FeaturePrEvidence[];\n}\n\n/** @stability Beta */\nexport interface FeatureCheckResult {\n ok: boolean;\n /** Hard failures: stale generated output, missing code paths, flag rules, removed ids, bad tags, no `@AGENTS.md`. */\n errors: string[];\n /** Everything else: reviews due, untested live features, uncovered routes, missing docs. */\n warnings: string[];\n /** Generated files that differ from what the generator makes now. */\n stale: string[];\n expiredFlags: string[];\n /** Building features with someone on them: `[id, claimedBy]`. */\n claims: [string, string][];\n /** Planned features with shipped work; each is also a warning. */\n plannedButShipped: PlannedButShipped[];\n}\n\nconst CODE = \"{ts,tsx,js,jsx,mjs,cjs}\";\nconst DEFAULT_SCAN = [`src/**/*.${CODE}`, `app/**/*.${CODE}`, `packages/*/src/**/*.${CODE}`];\nconst DEFAULT_TESTS = [`**/*.{test,spec}.${CODE}`, \"**/__tests__/**/*\", \"supabase/tests/**/*.sql\"];\nconst DEFAULT_COVERAGE = [`src/routes/**/*.${CODE}`, `app/routes/**/*.${CODE}`, \"**/*.functions.ts\"];\nconst DEFAULT_COVERAGE_IGNORE = [\"**/routeTree.gen.ts\", \"**/__root.tsx\", \"**/*.d.ts\"];\nconst DEFAULT_ACCESSORS = [\"useFlag\", \"getFlag\", \"<Flag name>\"];\nconst SKIP_DIRS = new Set([\"node_modules\", \"dist\", \"build\", \"coverage\", \"out\", \"storybook-static\"]);\n\n/** A file's text with CRLF line endings read as LF, so a Windows checkout isn't \"stale\" forever. */\nfunction read(file: string): string | null {\n return existsSync(file) ? readFileSync(file, \"utf8\").replace(/\\r\\n/g, \"\\n\") : null;\n}\n\n/** A glob (`*`, `**`, `?`, `{a,b}`) as a RegExp over `/`-separated relative paths. */\nexport function globToRegExp(glob: string): RegExp {\n let out = \"\";\n for (let i = 0; i < glob.length; i++) {\n const c = glob[i]!;\n if (c === \"*\" && glob[i + 1] === \"*\") {\n const slash = glob[i + 2] === \"/\";\n out += slash ? \"(?:.*/)?\" : \".*\";\n i += slash ? 2 : 1;\n } else if (c === \"*\") out += \"[^/]*\";\n else if (c === \"?\") out += \"[^/]\";\n else if (c === \"{\") {\n const close = glob.indexOf(\"}\", i);\n out += `(?:${glob.slice(i + 1, close).split(\",\").map((s) => s.replace(/[.+^$()|[\\]\\\\]/g, \"\\\\$&\")).join(\"|\")})`;\n i = close;\n } else out += c.replace(/[.+^$()|[\\]\\\\]/g, \"\\\\$&\");\n }\n return new RegExp(`^${out}$`);\n}\n\n/** Every file under `root`, skipping dot-folders, node_modules and build output. */\nfunction listFiles(root: string): string[] {\n const out: string[] = [];\n const walk = (rel: string) => {\n let entries;\n try {\n entries = readdirSync(join(root, rel), { withFileTypes: true });\n } catch {\n return;\n }\n for (const entry of entries) {\n const path = rel ? `${rel}/${entry.name}` : entry.name;\n if (entry.isDirectory()) {\n if (!entry.name.startsWith(\".\") && !SKIP_DIRS.has(entry.name)) walk(path);\n } else if (entry.isFile()) out.push(path);\n }\n };\n walk(\"\");\n return out;\n}\n\nfunction matcher(globs: readonly string[]) {\n const res = globs.map(globToRegExp);\n return (path: string) => res.some((re) => re.test(path));\n}\n\n/** A position in a file, as `path:line`. */\nconst at = (path: string, text: string, index: number) => `${path}:${text.slice(0, index).split(\"\\n\").length}`;\n\n/** The string literal starting at `text[i]`, or null when the expression there isn't one. */\nfunction literalAt(text: string, i: number): string | null {\n const quote = text[i];\n if (quote !== '\"' && quote !== \"'\" && quote !== \"`\") return null;\n const end = text.indexOf(quote, i + 1);\n if (end === -1) return null;\n const value = text.slice(i + 1, end);\n if (quote === \"`\" && value.includes(\"${\")) return null;\n return value;\n}\n\n/**\n * `text` with its comments blanked to spaces (newlines kept), so a flag named\n * in a comment isn't read as a flag read and line numbers stay right. Strings,\n * regex literals and template text are left alone; a template's `${…}` is code.\n * With `strings`, string and template-text contents are blanked too (quotes\n * stay), so prose in a string (\"…the release flag (off)\") can't look like a call.\n */\nexport function blankComments(text: string, strings = false): string {\n return blankFrom(text, 0, false, strings).out;\n}\n\n// Characters after which a `/` starts a regex literal rather than a division.\nconst BEFORE_REGEX = new Set(\"(,=:[!&|?{};+-*%<>~^\");\nconst REGEX_KEYWORDS = /(?:^|[^\\w$.])(?:return|typeof|instanceof|in|new|delete|void|throw|case|do|else|yield|await)$/;\n\n/**\n * Blanks comments from `i`, keeping strings, regex literals and template text.\n * With `inTemplate`, stops at the `}` that closes a template's `${`, so\n * interpolations are scanned as code.\n */\nfunction blankFrom(text: string, i: number, inTemplate: boolean, strings = false): { out: string; end: number } {\n const keep = (chunk: string) => (strings ? chunk.replace(/[^\\n]/g, \" \") : chunk);\n let out = \"\";\n let depth = 0;\n while (i < text.length) {\n const c = text[i]!;\n const next = text[i + 1];\n if (inTemplate && c === \"}\" && depth === 0) return { out, end: i };\n if (c === \"{\") depth++;\n else if (c === \"}\") depth--;\n if (c === \"/\" && next === \"/\") {\n const end = text.indexOf(\"\\n\", i);\n const stop = end === -1 ? text.length : end;\n out += \" \".repeat(stop - i);\n i = stop;\n } else if (c === \"/\" && next === \"*\") {\n const end = text.indexOf(\"*/\", i + 2);\n const stop = end === -1 ? text.length : end + 2;\n out += text.slice(i, stop).replace(/[^\\n]/g, \" \");\n i = stop;\n } else if (c === \"/\" && next !== \">\" && startsRegex(out)) {\n // A regex literal: `/[/*]/` holds no comment. Classes may contain `/`.\n let j = i + 1;\n let inClass = false;\n while (j < text.length && text[j] !== \"\\n\") {\n const r = text[j]!;\n if (r === \"\\\\\") j += 2;\n else {\n if (r === \"[\") inClass = true;\n else if (r === \"]\") inClass = false;\n else if (r === \"/\" && !inClass) break;\n j++;\n }\n }\n if (text[j] !== \"/\") {\n // No closing `/` on the line: a division after all.\n out += c;\n i++;\n continue;\n }\n out += text.slice(i, j + 1);\n i = j + 1;\n } else if (c === \"`\") {\n // Template text is kept; each `${…}` is scanned as code.\n out += c;\n let j = i + 1;\n while (j < text.length && text[j] !== \"`\") {\n if (text[j] === \"\\\\\") {\n out += keep(text.slice(j, j + 2));\n j += 2;\n } else if (text[j] === \"$\" && text[j + 1] === \"{\") {\n out += \"${\";\n const inner = blankFrom(text, j + 2, true, strings);\n out += inner.out;\n j = inner.end;\n if (j < text.length) out += text[j]!;\n j++;\n } else {\n out += keep(text[j]!);\n j++;\n }\n }\n if (j < text.length) out += \"`\";\n i = j + 1;\n } else if (c === '\"' || c === \"'\") {\n let j = i + 1;\n while (j < text.length && text[j] !== c && text[j] !== \"\\n\") j += text[j] === \"\\\\\" ? 2 : 1;\n if (text[j] === c) {\n out += c + keep(text.slice(i + 1, j)) + c;\n i = j + 1;\n } else {\n // No closing quote on this line: JSX text (\"Don't\"), not a string.\n out += c;\n i++;\n }\n } else {\n out += c;\n i++;\n }\n }\n return { out, end: i };\n}\n\nfunction startsRegex(before: string): boolean {\n const trimmed = before.replace(/\\s+$/, \"\");\n if (trimmed === \"\") return true;\n // `</p>` closes a JSX tag; a regex right after `<` is vanishingly rare.\n if (before.endsWith(\"<\")) return false;\n return BEFORE_REGEX.has(trimmed[trimmed.length - 1]!) || REGEX_KEYWORDS.test(trimmed);\n}\n\n/**\n * Flag reads in `text`: each key read through an accessor with a literal, and\n * each read whose key isn't a literal (`dynamic`), as `path:line`. Comments\n * don't count.\n */\nexport function scanFlagReads(path: string, source: string, accessors: readonly string[] = DEFAULT_ACCESSORS) {\n const text = blankComments(source);\n // Matches run on code with string contents blanked; literal keys are read from `text`.\n const code = blankComments(source, true);\n const keys: { key: string; where: string }[] = [];\n const dynamic: string[] = [];\n for (const accessor of accessors) {\n const jsx = /^<(\\w[\\w.]*)\\s+(\\w+)>$/.exec(accessor);\n if (jsx) {\n const re = new RegExp(`<${jsx[1]!.replace(/\\./g, \"\\\\.\")}\\\\b[^>]*?\\\\b${jsx[2]}\\\\s*=\\\\s*`, \"g\");\n for (const m of code.matchAll(re)) {\n let i = m.index! + m[0].length;\n if (text[i] === \"{\") i = text.slice(i + 1).search(/\\S/) + i + 1;\n const key = literalAt(text, i);\n if (key === null) dynamic.push(at(path, text, m.index!));\n else keys.push({ key, where: at(path, text, m.index!) });\n }\n continue;\n }\n const re = new RegExp(`(?<![\\\\w$.])(function\\\\s+)?${accessor.replace(/\\$/g, \"\\\\$\")}\\\\s*(?:<[^>()]*>)?\\\\s*\\\\(\\\\s*`, \"g\");\n for (const m of code.matchAll(re)) {\n if (m[1]) continue; // its own definition\n const i = m.index! + m[0].length;\n if (text[i] === \")\") continue;\n const key = literalAt(text, i);\n if (key !== null) keys.push({ key, where: at(path, text, m.index!) });\n // `useFlag(key: K)` in a type or a signature declares the accessor; it doesn't read a flag.\n else if (!/^[\\w$]+\\??\\s*:/.test(text.slice(i))) dynamic.push(at(path, text, m.index!));\n }\n }\n return { keys, dynamic };\n}\n\nconst ids = (features: Features) => new Set(Object.entries(features).flatMap(([id, f]) => [id, ...(f.aliases ?? [])]));\n\n/** Ids recorded in the committed JSON that the registry no longer has, as an id or an alias. */\nfunction removedIds(options: FeatureProjectOptions): string[] {\n const json = options.json === undefined ? \"features.json\" : options.json;\n if (!json) return [];\n const doc = read(join(options.root, json));\n if (!doc) return [];\n let previous: string[];\n try {\n previous = (JSON.parse(doc) as { features?: { id: string; aliases?: string[] }[] }).features?.flatMap((f) => [f.id, ...(f.aliases ?? [])]) ?? [];\n } catch {\n return [];\n }\n const now = ids(options.features);\n return previous.filter((id) => !now.has(id));\n}\n\n/** Each id and alias, mapped to its feature's id. */\nconst canonical = (features: Features) =>\n new Map(Object.entries(features).flatMap(([id, f]) => [id, ...(f.aliases ?? [])].map((name) => [name, id] as const)));\n\n/** \"a\", \"a and b\", \"a, b and c\". */\nconst and = (items: string[]) => (items.length < 2 ? items.join(\"\") : `${items.slice(0, -1).join(\", \")} and ${items.at(-1)}`);\n\nconst removedMessage = (id: string) =>\n `the feature id \"${id}\" was removed. Ids are permanent: keep the entry with status \"retired\", or list \"${id}\" in the new entry's aliases`;\n\n/** Every generated file: its path, and its content given what's on disk now. */\nfunction outputs(options: FeatureProjectOptions): { path: string; next: (current: string | null) => string; same: (current: string | null, next: string) => boolean }[] {\n const { features, flags, source, command } = options;\n const agents = options.agents === undefined ? \"AGENTS.md\" : options.agents;\n const json = options.json === undefined ? \"features.json\" : options.json;\n const openfeature = options.openfeature === undefined ? \"flags.json\" : options.openfeature;\n const skill = options.skill === undefined ? \".claude/skills/features/SKILL.md\" : options.skill;\n const whole = (content: string) => ({ next: () => content, same: (current: string | null, next: string) => current === next });\n const list = [];\n if (agents) {\n const block = toAgentsMarkdown(features, flags, { source, command, skill });\n list.push({\n path: agents,\n next: (current: string | null) => replaceAgentsBlock(current ?? \"\", block),\n same: (current: string | null) => current !== null && readAgentsBlock(current) === block,\n });\n }\n if (json) list.push({ path: json, ...whole(toJson(features, flags, { source })) });\n if (openfeature && flags && Object.keys(flags).length) list.push({ path: openfeature, ...whole(toOpenFeatureManifest(flags, features)) });\n const writesFlags = Boolean(openfeature && flags && Object.keys(flags).length);\n const generated = [\n ...(agents ? [`the ${agents} block`] : []),\n ...(json ? [`\\`${json}\\``] : []),\n ...(writesFlags ? [`\\`${openfeature}\\` (the OpenFeature flag manifest)`] : []),\n ...(options.marketing ? [`the ${options.marketing} Features section`] : []),\n ...(skill ? [\"this skill\"] : []),\n ];\n if (skill) list.push({ path: skill, ...whole(toSkillMarkdown({ source, command, outputs: generated })) });\n if (options.marketing) {\n const block = toMarketingMarkdown(features, { heading: options.marketingHeading, source });\n list.push({\n path: options.marketing,\n next: (current: string | null) => replaceBlock(current ?? \"\", block, MARKETING_BLOCK_START, MARKETING_BLOCK_END),\n same: (current: string | null) => current !== null && readBlock(current, MARKETING_BLOCK_START, MARKETING_BLOCK_END) === block,\n });\n }\n return list;\n}\n\nfunction claudeImport(options: FeatureProjectOptions): { path: string; line: string } | null {\n const agents = options.agents === undefined ? \"AGENTS.md\" : options.agents;\n const claude = options.claude === undefined ? \"CLAUDE.md\" : options.claude;\n return agents && claude ? { path: claude, line: `@${agents}` } : null;\n}\n\nconst hasImport = (doc: string | null, line: string) =>\n doc !== null && new RegExp(`^${line.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\\\s*$`, \"m\").test(doc);\n\n/**\n * Writes every generated output (the AGENTS.md block, the JSON, the flag\n * manifest, the skill, the marketing block) and adds `@AGENTS.md` to\n * CLAUDE.md when it's missing. Refuses, writing nothing, when an id recorded\n * in the JSON has disappeared. Returns the paths it changed.\n *\n * @stability Beta\n */\nexport function buildFeatureOutputs(options: FeatureProjectOptions): string[] {\n const removed = removedIds(options);\n if (removed.length) throw new Error(removed.map(removedMessage).join(\"\\n\"));\n const changed: string[] = [];\n const write = (rel: string, next: string) => {\n const file = join(options.root, rel);\n mkdirSync(dirname(file), { recursive: true });\n writeFileSync(file, next);\n changed.push(rel);\n };\n for (const output of outputs(options)) {\n const current = read(join(options.root, output.path));\n let next: string;\n try {\n next = output.next(current);\n } catch (error) {\n if (error instanceof BrokenBlockError) throw new Error(`${output.path}: ${error.message}`);\n throw error;\n }\n if (!output.same(current, next)) write(output.path, next);\n }\n const claude = claudeImport(options);\n if (claude) {\n const current = read(join(options.root, claude.path));\n if (!hasImport(current, claude.line)) {\n const base = current === null || current === \"\" ? \"\" : current.endsWith(\"\\n\") ? `${current}\\n` : `${current}\\n\\n`;\n write(claude.path, `${base}${claude.line}\\n`);\n }\n }\n return changed;\n}\n\n/**\n * Checks the registry against the repo. Errors (exit 1): generated output that\n * is stale, `links.code` paths that don't exist, the flag rules (a permission\n * flag, an expired flag, a dynamic key, a key read but not defined or defined\n * but never read, a missing runbook), an id that disappeared, an unknown id in\n * a test, changeset or PR tag, and a CLAUDE.md without `@AGENTS.md`.\n * Warnings: reviews due, live features without tagged tests, planned features\n * with shipped work (changesets, and `evidence.prs`), route and\n * server-function files no feature covers, missing docs.\n *\n * It only ever compares generated output with the generator, never two\n * hand-written files.\n *\n * @stability Beta\n */\nexport function checkFeatureOutputs(options: FeatureProjectOptions): FeatureCheckResult {\n const { root, features, flags } = options;\n const today = options.today ?? new Date().toISOString().slice(0, 10);\n const errors: string[] = [];\n const warnings: string[] = [];\n const stale: string[] = [];\n const known = ids(features);\n\n for (const output of outputs(options)) {\n const current = read(join(root, output.path));\n let same: boolean;\n try {\n same = output.same(current, output.next(current));\n } catch (error) {\n if (!(error instanceof BrokenBlockError)) throw error;\n errors.push(`${output.path}: ${error.message}`);\n continue;\n }\n if (!same) {\n stale.push(output.path);\n errors.push(`${output.path} is stale. Run \\`${options.command ?? \"genesis features\"} build\\` and commit the result.`);\n }\n }\n const claude = claudeImport(options);\n if (claude && !hasImport(read(join(root, claude.path)), claude.line)) {\n errors.push(`${claude.path} must import the agent notes with a line \\`${claude.line}\\` (\\`build\\` adds it).`);\n }\n for (const id of removedIds(options)) errors.push(removedMessage(id));\n\n const reviewCutoff = new Date(Date.parse(today) - (options.reviewDays ?? 90) * 86_400_000).toISOString().slice(0, 10);\n const claims: [string, string][] = [];\n for (const [id, def] of Object.entries(features)) {\n for (const path of def.links?.code ?? []) {\n if (!existsSync(join(root, path))) errors.push(`${id}.links.code: ${path} doesn't exist`);\n }\n for (const path of def.links?.docs ?? []) {\n if (!/^https?:\\/\\//.test(path) && !existsSync(join(root, path))) warnings.push(`${id}.links.docs: ${path} doesn't exist`);\n }\n if (def.claimedBy) claims.push([id, def.claimedBy]);\n if (def.status !== \"planned\" && def.status !== \"retired\") {\n if (!def.reviewedAt) warnings.push(`${id}: never reviewed (set reviewedAt)`);\n else if (def.reviewedAt < reviewCutoff) warnings.push(`${id}: last reviewed ${def.reviewedAt}, over ${options.reviewDays ?? 90} days ago`);\n }\n }\n\n const files = listFiles(root);\n const expired = expiredFlags(flags, today);\n if (flags) {\n for (const [name, flag] of Object.entries(flags)) {\n if (flag.kind === \"permission\") errors.push(`${name}: a permission flag. Paid or role access belongs in the feature's \\`access\\` (entitlements), not a flag`);\n if (flag.runbook && !/^https?:\\/\\//.test(flag.runbook) && !existsSync(join(root, flag.runbook))) {\n errors.push(`${name}.runbook: ${flag.runbook} doesn't exist`);\n }\n }\n for (const name of expired) errors.push(`${name} expired on ${flags[name]!.expires}: remove its code path, then the flag`);\n if (options.scan !== false) {\n const inScan = matcher(options.scan ?? DEFAULT_SCAN);\n const skipped = matcher(options.scanIgnore ?? (options.tests || DEFAULT_TESTS));\n const used = new Map<string, string>();\n for (const path of files.filter((p) => inScan(p) && !skipped(p) && !p.endsWith(\".d.ts\"))) {\n const { keys, dynamic } = scanFlagReads(path, readFileSync(join(root, path), \"utf8\"), options.flagAccessors ?? DEFAULT_ACCESSORS);\n for (const where of dynamic) errors.push(`${where}: a flag read with a computed key. Use a literal key, so the read can be checked`);\n for (const { key, where } of keys) {\n if (!Object.hasOwn(flags, key)) errors.push(`${where}: the flag \"${key}\" is read but not defined`);\n if (!used.has(key)) used.set(key, where);\n }\n }\n for (const name of Object.keys(flags)) {\n if (!used.has(name)) errors.push(`${name}: defined but never read. Remove it, or read it through the flag accessor`);\n }\n }\n }\n\n const tagged = new Set<string>();\n if (options.tests !== false) {\n const inTests = matcher(options.tests ?? DEFAULT_TESTS);\n for (const path of files.filter(inTests)) {\n const text = readFileSync(join(root, path), \"utf8\");\n for (const m of text.matchAll(/@feat:([a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*)/g)) {\n if (!known.has(m[1]!)) errors.push(`${at(path, text, m.index!)}: @feat:${m[1]} is not a feature`);\n else tagged.add(m[1]!);\n }\n }\n for (const [id, def] of Object.entries(features)) {\n const names = [id, ...(def.aliases ?? [])];\n if (def.status === \"live\" && !names.some((n) => tagged.has(n))) warnings.push(`${id}: live, but no test is tagged @feat:${id}`);\n }\n }\n\n const idOf = canonical(features);\n const shippedIn = new Map<string, { changesets: string[]; prs: FeaturePrEvidence[] }>();\n const shipped = (name: string) => {\n const id = idOf.get(name)!;\n if (!shippedIn.has(id)) shippedIn.set(id, { changesets: [], prs: [] });\n return shippedIn.get(id)!;\n };\n const changesets = options.changesets === undefined ? \".changeset\" : options.changesets;\n if (changesets) {\n for (const path of listChangesets(root, changesets)) {\n // The body only, so frontmatter never counts; CRLF read as LF.\n const text = read(join(root, path))!.replace(/^---\\n[\\s\\S]*?\\n---\\n/, \"\");\n for (const m of text.matchAll(/^features:[ \\t]*\\[?([^\\]\\n]*)\\]?[ \\t]*$/gim)) {\n for (const id of m[1]!.split(/[\\s,]+/).filter(Boolean)) {\n if (!known.has(id)) errors.push(`${path}: Features: ${id} is not a feature`);\n else if (!shipped(id).changesets.includes(path)) shipped(id).changesets.push(path);\n }\n }\n }\n }\n for (const [name, prs] of Object.entries(options.evidence?.prs ?? {})) {\n if (!known.has(name)) continue;\n const list = shipped(name).prs;\n for (const pr of prs) if (!list.some((p) => p.number === pr.number)) list.push(pr);\n }\n const plannedButShipped: PlannedButShipped[] = [];\n for (const [id, def] of Object.entries(features)) {\n const found = shippedIn.get(id);\n if (def.status !== \"planned\" || !found || (!found.changesets.length && !found.prs.length)) continue;\n const prs = [...found.prs].sort((a, b) => a.number - b.number);\n plannedButShipped.push({ id, changesets: found.changesets, prs });\n warnings.push(`${id} is still planned, but ${and([...found.changesets, ...prs.map((p) => `PR #${p.number}`)])} shipped work for it`);\n }\n for (const label of options.labels ?? []) {\n const id = /^feature:(.+)$/.exec(label.trim())?.[1];\n if (id && !known.has(id)) errors.push(`PR label ${label}: ${id} is not a feature`);\n }\n\n if (options.coverage !== false) {\n const inCoverage = matcher(options.coverage ?? DEFAULT_COVERAGE);\n const ignored = matcher(options.coverageIgnore ?? DEFAULT_COVERAGE_IGNORE);\n const covered = Object.values(features).flatMap((f) => f.links?.code ?? []).map((p) => p.replace(/\\/+$/, \"\"));\n for (const path of files.filter((p) => inCoverage(p) && !ignored(p))) {\n if (!covered.some((c) => path === c || path.startsWith(`${c}/`))) warnings.push(`${path}: no feature's links.code covers it`);\n }\n }\n\n return { ok: errors.length === 0, errors, warnings, stale, expiredFlags: expired, claims, plannedButShipped };\n}\n\nfunction listChangesets(root: string, dir: string): string[] {\n try {\n return readdirSync(join(root, dir))\n .filter((f) => f.endsWith(\".md\") && f.toLowerCase() !== \"readme.md\")\n .map((f) => `${dir}/${f}`);\n } catch {\n return [];\n }\n}\n\n/**\n * A few lines for a session's start: counts, stale output, expired flags,\n * planned features with shipped work and open claims. Meant for a SessionStart hook (`genesis features check --summary`).\n *\n * @stability Beta\n */\nexport function summarizeCheck(result: FeatureCheckResult, features: Features): string {\n const total = Object.keys(features).length;\n const lines = [\n `Features: ${total} in the registry; ${result.errors.length} error${result.errors.length === 1 ? \"\" : \"s\"}, ${result.warnings.length} warning${result.warnings.length === 1 ? \"\" : \"s\"}.`,\n ];\n if (result.stale.length) lines.push(`- Stale generated files: ${result.stale.join(\", \")}. Run the features build.`);\n if (result.expiredFlags.length) lines.push(`- Expired flags: ${result.expiredFlags.join(\", \")}. Remove the code path, then the flag.`);\n if (result.plannedButShipped.length) {\n const n = result.plannedButShipped.length;\n lines.push(`- ${n} planned feature${n === 1 ? \" has\" : \"s have\"} shipped work: ${result.plannedButShipped.map((s) => s.id).join(\", \")}. Move ${n === 1 ? \"its\" : \"their\"} status on.`);\n }\n if (result.claims.length) lines.push(`- Being built: ${result.claims.map(([id, by]) => `${id} (${by})`).join(\", \")}.`);\n const other = result.errors.length - result.stale.length - result.expiredFlags.length;\n if (other > 0) lines.push(`- ${other} other error${other === 1 ? \"\" : \"s\"}: run the features check for details.`);\n return lines.join(\"\\n\");\n}\n"]}
|
package/dist/react.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
"use client";
|
|
2
|
-
import { FEATURE_STATUSES, toRecords, marketingRecords, FEATURE_HORIZONS } from './chunk-
|
|
2
|
+
import { FEATURE_STATUSES, toRecords, marketingRecords, FEATURE_HORIZONS } from './chunk-ZYWK7XPT.js';
|
|
3
3
|
import { useMemo, useState } from 'react';
|
|
4
4
|
import { AppWindow, Users, Eye } from 'lucide-react';
|
|
5
5
|
import { StatusBadge, Badge, Section, Card, CardHeader, CardTitle, CardDescription, CardContent } from '@marktiderman/genesis-ui';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@marktiderman/genesis-features",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"sideEffects": false,
|
|
@@ -57,9 +57,9 @@
|
|
|
57
57
|
}
|
|
58
58
|
},
|
|
59
59
|
"devDependencies": {
|
|
60
|
-
"@marktiderman/genesis-core": "^1.5.
|
|
60
|
+
"@marktiderman/genesis-core": "^1.5.1",
|
|
61
61
|
"@marktiderman/genesis-design-system": "^1.3.1",
|
|
62
|
-
"@marktiderman/genesis-ui": "^2.
|
|
62
|
+
"@marktiderman/genesis-ui": "^2.10.1",
|
|
63
63
|
"@testing-library/react": "^16.3.2",
|
|
64
64
|
"@types/node": "^22.9.0",
|
|
65
65
|
"@types/react": "^19.2.14",
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/model.ts","../src/generate.ts"],"names":[],"mappings":"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","file":"chunk-YKNISEPJ.js","sourcesContent":["import { z } from \"zod\";\n\n/**\n * Where a feature is in its life. The order is the board's column order.\n *\n * @stability Beta\n */\nexport const FEATURE_STATUSES = [\"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/** 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}\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/** 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 })\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 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 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 if (problems.length) throw new FeatureRegistryError(problems);\n return Object.freeze(features);\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 * Features matching `term` in their id, aliases, name, summary, tagline,\n * category or code paths, best matches (id and name) first.\n *\n * @stability Beta\n */\nexport function findFeatures(features: Features, term: string, flags?: Flags): FeatureRecord[] {\n const needle = term.trim().toLowerCase();\n if (!needle) return [];\n const score = (r: FeatureRecord) => {\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.flags.some((f) => f.toLowerCase().includes(needle))) return 2;\n const rest = [r.summary, r.tagline, r.category, ...(r.links?.code ?? []), ...(r.aliases ?? [])];\n return rest.some((v) => v?.toLowerCase().includes(needle)) ? 3 : -1;\n };\n return toRecords(features, flags)\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`.\n *\n * @stability Beta\n */\nexport function toSkillMarkdown(options: GenerateOptions = {}): string {\n const source = options.source ?? \"src/features.ts\";\n const command = options.command ?? \"genesis features\";\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 every\nother copy (the AGENTS.md block, JSON, the flags manifest, the admin page) is generated from it.\n\n## Find\n- \\`${command} find <term>\\` searches ids, aliases, names, summaries and code paths. Run it before\n building anything new: extend the feature that already covers it rather than adding a second one.\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 - \\`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\\`.\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: planned, building, beta, live, deprecated, retired. \\`check\\` warns when a\n 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"]}
|