gcf-aif-ext 0.2.7 → 0.4.0

package/templates/system.md

@@ -1,6 +1,6 @@
 ---
 system: example-system
-updated_by: card-000
+updated_by: example
 ---
 
 purpose:

package/lib/validate-card.js

@@ -1,82 +0,0 @@
-// Runtime mirror of schemas/card.schema.json for the pre-commit hook (no ajv in
-// production deps). The parity test keeps the two in agreement.
-const FIELDS = [
-  'schema',
-  'id',
-  'slug',
-  'status',
-  'route',
-  'system',
-  'depends',
-  'source',
-  'tune_count',
-  'built_at',
-  'created',
-];
-const REQUIRED = FIELDS.filter((f) => f !== 'built_at');
-
-const RULES = {
-  schema: (v) => v === 1 || 'schema must be 1',
-  id: (v) => /^card-\d{3}$/.test(v) || 'id must match card-NNN',
-  slug: (v) => /^[a-z0-9]+(-[a-z0-9]+)*$/.test(v) || 'slug must be a lowercase hyphen slug',
-  status: (v) =>
-    ['proposed', 'built', 'tuning'].includes(v) ||
-    `status "${v}" is not storable (П1: terminal statuses never live in a file)`,
-  route: (v) => ['soft', 'hard'].includes(v) || 'route must be soft or hard',
-  system: (v) =>
-    (Array.isArray(v) && v.length >= 1 && v.every((s) => /^[a-z0-9]+(-[a-z0-9]+)*$/.test(s))) ||
-    'system must list >=1 subsystem slugs',
-  depends: (v) =>
-    (Array.isArray(v) && v.every((d) => /^card-\d{3}$/.test(d))) ||
-    'depends must list card-NNN ids',
-  source: (v) =>
-    /^(GDD#[A-Za-z0-9_-]+|manual|inferred)$/.test(v) ||
-    'source must be GDD#<id>, manual or inferred',
-  tune_count: (v) => (Number.isInteger(v) && v >= 0) || 'tune_count must be an integer >= 0',
-  built_at: (v) =>
-    v === null ||
-    v === undefined ||
-    /^[0-9a-f]{7,40}$/.test(v) ||
-    'built_at must be null or a commit hash',
-  created: (v) => /^\d{4}-\d{2}-\d{2}$/.test(dateStr(v)) || 'created must be YYYY-MM-DD',
-};
-
-const dateStr = (v) => (v instanceof Date ? v.toISOString().slice(0, 10) : String(v));
-
-const UNTIL_OK = /^\[until:\s*(verdict\(card-\d{3}\)|retune\([a-z0-9-]+\)|manual\([^)]*\))\]$/;
-
-/** Validate card frontmatter. Returns a list of one-line errors (empty = valid). */
-export function validateCard(data) {
-  const errors = [];
-  for (const key of REQUIRED) if (!(key in data)) errors.push(`missing field: ${key}`);
-  for (const key of Object.keys(data)) {
-    if (!FIELDS.includes(key))
-      errors.push(
-        `unknown field: ${key}` +
-          (key === 'until' ? ' (until: is a line annotation, not frontmatter)' : ''),
-      );
-    else if (key in RULES) {
-      const res = RULES[key](data[key]);
-      if (res !== true) errors.push(res);
-    }
-  }
-
-  return errors;
-}
-
-/** Validate every `[until: ...]` annotation in a body against the trigger grammar (§7.3). */
-export function validateUntil(body) {
-  const errors = [];
-  const lines = String(body).split('\n');
-  lines.forEach((line, i) => {
-    for (const m of line.matchAll(/\[until:[^\]]*\]/g)) {
-      if (!UNTIL_OK.test(m[0]))
-        errors.push(
-          `line ${i + 1}: bad until annotation ${m[0]} ` +
-            '(use verdict(card-NNN), retune(system) or manual(text))',
-        );
-    }
-  });
-
-  return errors;
-}

package/profiles/card.md

@@ -1,65 +0,0 @@
----
-name: card
-description: The CNL-P profile of a GCF feature card — the six slots a card body carries, in order.
----
-
-format: cnlp-format.md
-
-mood: declarative
-
-headings:
-- none: the body is flat and the document is named by its frontmatter or its fixed path
-
-frontmatter_fields:
-- schema
-- id
-- slug
-- status
-- route
-- system
-- depends
-- source
-- tune_count
-- built_at
-- created
-
-lexicon_exempt:
-- none: every field of a card body is read at planning time and must stay unambiguous
-
-sections:
-- key: behavior
-  form: bullet-list
-  required: yes
-  note: player input -> state change -> feedback, one observable statement per line
-
-- key: contract
-  form: bullet-list
-  required: yes
-  note: entities, components and data flows the feature adds; paths and entry points, never member lists or values
-
-- key: feel
-  form: bullet-list
-  required: yes
-  note: a comparison line (like X, not like Y) plus envelope lines; envelopes are the only legal numbers in gcf documents
-
-- key: interactions
-  form: bullet-list
-  required: yes
-  note: existing mechanics this feature crosses; a soft line may end with an "[until: ...]" annotation
-
-- key: constraints
-  form: bullet-list
-  required: yes
-  note: negative constraints, one prohibition per line, checkable by an analyzer or a reviewer
-
-- key: miss_criterion
-  form: scalar
-  required: yes
-  note: the one question the game in hand answers; the human answers it at the verdict
-
-custom_sections:
-- none: a card block that is not listed above is prose looking for a home
-
-enforcement:
-- `npx cnlp check`, over the files a `cnlp.config.json` corpus entry maps to this profile
-- frontmatter is validated separately by `schemas/card.schema.json` in the gcf pre-commit hook

package/schemas/card.schema.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://github.com/VirtualMaestro/GCF/schemas/card.schema.json",
-  "title": "GCF card frontmatter",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schema", "id", "slug", "status", "route", "system", "depends", "source", "tune_count", "created"],
-  "properties": {
-    "schema": { "const": 1 },
-    "id": { "type": "string", "pattern": "^card-\\d{3}$" },
-    "slug": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
-    "status": { "enum": ["proposed", "built", "tuning"] },
-    "route": { "enum": ["soft", "hard"] },
-    "system": {
-      "type": "array",
-      "minItems": 1,
-      "items": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" }
-    },
-    "depends": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^card-\\d{3}$" }
-    },
-    "source": { "type": "string", "pattern": "^(GDD#[A-Za-z0-9_-]+|manual|inferred)$" },
-    "tune_count": { "type": "integer", "minimum": 0 },
-    "built_at": {
-      "anyOf": [{ "type": "null" }, { "type": "string", "pattern": "^[0-9a-f]{7,40}$" }]
-    },
-    "created": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }
-  }
-}

package/templates/card.md

@@ -1,34 +0,0 @@
----
-schema: 1
-id: card-000
-slug: example
-status: proposed
-route: soft
-system: [example-system]
-depends: []
-source: manual
-tune_count: 0
-built_at: null
-created: "2026-01-01"
----
-
-behavior:
-- player presses X -> the character does Y -> the screen shows Z
-
-contract:
-- new components and systems live under Assets/Scripts/Example/
-- data flows from input to simulation, never backwards
-
-feel:
-- like Hades, not like Celeste
-- duration 0.15..0.25 s
-- cooldown 0.4..0.8 s
-
-interactions:
-- none: this example crosses no existing mechanic
-
-constraints:
-- do not add a new input binding
-- no per-frame allocations
-
-miss_criterion: does the move feel responsive on the first try