wingfoil 0.2.2 → 0.3.0

package/dist/workflow/bindings.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BindingsYaml = exports.ActionBinding = exports.CheckBinding = exports.BINDINGS_FILE = void 0;
+exports.collectionEntryKey = collectionEntryKey;
+exports.collectionKeyIssues = collectionKeyIssues;
+exports.tokenName = tokenName;
+exports.memoryAddType = memoryAddType;
+exports.typedStateType = typedStateType;
+exports.isBuiltinToken = isBuiltinToken;
+exports.resolveToken = resolveToken;
+exports.isWholeInterpolation = isWholeInterpolation;
+exports.runsAgentExecute = runsAgentExecute;
+/**
+ * Layer 3 — the token-binding file `.wingfoil/workflows/bindings.yaml` (spec-003-workflows-yaml-schema
+ * § "Layer 3", `dl-090` Q1 (a), Q2 (c), Q3 (a), Q4, Q5 (c), Q6), and the **built-in** binding table
+ * (spec-003 § "Action expressions"). Every `actions:` and `checks:` token of a workflow resolves through
+ * one of the two: a token WingFoil implements itself is built in and may not be rebound; every other
+ * token is bound by the project here, or is unbound (`W_WORKFLOW_UNBOUND_TOKEN`, a warning in v0.3).
+ *
+ * Like `./schema.ts`, this module holds the **structural** (Zod) shape plus the pure readings the
+ * loader's checks and later commands share ({@link tokenName}, {@link isBuiltinToken},
+ * {@link resolveToken}, {@link isWholeInterpolation}, {@link runsAgentExecute}). The loader rows
+ * themselves are run by `src/core/loaders.ts` with `src/core/workflow-diagnostics.ts`
+ * (spec-009-validation-strategy §1). Every object node is `.passthrough()` per spec-009 §2, except
+ * where spec-003's shape is strict.
+ *
+ * Nothing here runs a binding: in v0.3 the loader validates and `workflow show` / `workflow next`
+ * display (spec-003 § "What v0.3 does with these fields"); the v1.0 engine executes (P4.10, P4.12).
+ */
+const zod_1 = require("zod");
+const format_1 = require("../validation/format");
+const id_1 = require("../validation/id");
+/** The bindings file, relative to `.wingfoil/` — the `file` of its diagnostics (spec-003 Layer 3). */
+exports.BINDINGS_FILE = 'workflows/bindings.yaml';
+/** spec-009's ID characters, anchored: what a collection entry's key must match (spec-003 § "Collections"). */
+const ID_RE = new RegExp(`^[${id_1.ID_CHAR_CLASS}]+$`);
+/** An argument vector: the first element is the program; never passed to a shell (`dl-090` Q3 (a)). */
+const Argv = zod_1.z.array(zod_1.z.string()).min(1);
+/** `args`: one declared pattern per interpolated placeholder; each must compile as a regular expression. */
+const Args = zod_1.z.record(zod_1.z.string(), zod_1.z.string().superRefine((pattern, ctx) => {
+    try {
+        new RegExp(pattern);
+    }
+    catch (err) {
+        ctx.addIssue({ code: 'custom', message: `invalid argument pattern "${pattern}": ${err.message}` });
+    }
+}));
+/** A check token's binding: a command and a severity (`dl-090` Q4; default `reject`). */
+exports.CheckBinding = zod_1.z
+    .object({
+    run: Argv,
+    severity: zod_1.z.enum(['warn', 'reject']).default('reject'),
+    args: Args.optional(),
+})
+    .passthrough();
+/** An action token's binding: exactly one of `run` (a command) or `manual: true` (`dl-090` Q2 (c)). */
+exports.ActionBinding = zod_1.z
+    .object({
+    run: Argv.optional(),
+    manual: zod_1.z.literal(true).optional(),
+    args: Args.optional(),
+})
+    .passthrough()
+    .superRefine((binding, ctx) => {
+    if ((binding.run === undefined) === (binding.manual === undefined)) {
+        ctx.addIssue({ code: 'custom', message: 'an action binding declares exactly one of run or manual' });
+    }
+});
+/** One collection entry: a scalar, or a map keyed by its `id` (else its `name`) field. */
+const CollectionEntry = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())]);
+/**
+ * The key of one collection entry (spec-003 § "Collections"): the entry itself for a scalar, the
+ * entry's `id` field, else its `name` field, for a map. `null` when a map entry has neither as a
+ * scalar.
+ */
+function collectionEntryKey(entry) {
+    if (typeof entry !== 'object' || entry === null)
+        return String(entry);
+    const key = entry['id'] ?? entry['name'];
+    return typeof key === 'string' || typeof key === 'number' ? String(key) : null;
+}
+/**
+ * A named collection: a list of entries, in declared order. Its key rules (a key per entry, unique,
+ * in spec-009's ID characters) are a loader row, not part of this structural pass
+ * ({@link collectionKeyIssues}; approver ruling D1 (a), 2026-10-05), so a bad key leaves the rest of
+ * the file decided.
+ */
+const Collection = zod_1.z.array(CollectionEntry);
+/**
+ * The key problems of one collection (spec-003 § "Collections"), in entry order: a map entry with no
+ * `id` / `name`, a key outside spec-009's ID characters, a key already used by an earlier entry.
+ */
+function collectionKeyIssues(entries) {
+    const issues = [];
+    const seen = new Set();
+    entries.forEach((entry, index) => {
+        const key = collectionEntryKey(entry);
+        if (key === null) {
+            issues.push({ index, message: 'a collection entry map needs an id or name field' });
+            return;
+        }
+        if (!ID_RE.test(key))
+            issues.push({ index, message: `collection key '${key}' is outside the ID characters [${id_1.ID_CHAR_CLASS}]` });
+        if (seen.has(key))
+            issues.push({ index, message: `duplicate collection key '${key}'` });
+        seen.add(key);
+    });
+    return issues;
+}
+/**
+ * Layer 3 — `.wingfoil/workflows/bindings.yaml`. Optional: an absent file is no bindings. A `dl-149` file
+ * kind (`dl-153` (A)): `format` is optional (absent = 1), and a newer one is refused by the loader before
+ * this structural pass.
+ */
+exports.BindingsYaml = zod_1.z
+    .object({
+    version: zod_1.z.number().positive().optional(),
+    format: (0, format_1.formatField)(format_1.BINDINGS_YAML_FORMAT),
+    checks: zod_1.z.record(zod_1.z.string(), exports.CheckBinding).optional(),
+    actions: zod_1.z.record(zod_1.z.string(), exports.ActionBinding).optional(),
+    collections: zod_1.z.record(zod_1.z.string(), Collection).optional(),
+})
+    .passthrough();
+/**
+ * The name of an action or check token: the text before its first `(` or `:`, trimmed
+ * (`memory.add(type: adr)` → `memory.add`; `tests.coverage(min: 80)` → `tests.coverage`;
+ * `frontmatter.required: [title]` → `frontmatter.required`). A prose check keeps its prose, which no
+ * binding key names, so it stays unbound.
+ */
+function tokenName(token) {
+    const cut = token.search(/[(:]/);
+    return (cut === -1 ? token : token.slice(0, cut)).trim();
+}
+/** The `type:` argument of a `memory.add(...)` token, or `null` (`memory.add(type: tech-spec)` → `tech-spec`). */
+function memoryAddType(token) {
+    if (tokenName(token) !== 'memory.add')
+        return null;
+    const match = /\btype\s*:\s*["']?([^"',)\s]+)/.exec(token);
+    return match ? match[1] : null;
+}
+const MEMORY_VERB_TOKENS = {
+    'memory.add': 'add',
+    'memory.submit': 'submit',
+    'memory.approve': 'approve',
+    'memory.reject': 'reject',
+    'memory.deprecate': 'deprecate',
+};
+/** `<type>.set_state` / `<type>.sync_state` — `element` included, as the workflow's own element. */
+const TYPED_STATE_RE = /^([a-z][a-z0-9-]*)\.(set_state|sync_state)$/;
+/**
+ * The Memory type a typed state action names — the `T` of `<T>.set_state(…)` / `<T>.sync_state(…)` —
+ * or `null` for `element.set_state` / `element.sync_state` (the workflow's own element, not a type) and
+ * for any other token. The core check `E_WORKFLOW_ELEMENT_TYPE_UNKNOWN` (spec-003, `bug-282`) checks it
+ * against `memory.yaml`.
+ */
+function typedStateType(token) {
+    const typed = TYPED_STATE_RE.exec(tokenName(token));
+    return typed && typed[1] !== 'element' ? typed[1] : null;
+}
+/**
+ * Whether `name` (a {@link tokenName}) is a **built-in** token (spec-003's built-in table):
+ * `memory.add|submit|approve|reject|deprecate`, `element.set_state`, `<type>.set_state`,
+ * `<type>.sync_state`, `element.set_release`, `config.init` and every `agent.*`. A project may not
+ * rebind one (`E_BINDING_BUILTIN_TOKEN`).
+ */
+function isBuiltinToken(name) {
+    return (name in MEMORY_VERB_TOKENS ||
+        TYPED_STATE_RE.test(name) ||
+        name === 'element.set_release' ||
+        name === 'config.init' ||
+        name.startsWith('agent.'));
+}
+/** The built-in binding of an action token, or `null` when `name` is not built in. */
+function builtinBinding(token, name) {
+    const verb = MEMORY_VERB_TOKENS[name];
+    if (verb !== undefined) {
+        const type = memoryAddType(token);
+        const argv = ['wingfoil', 'memory', verb, ...(verb === 'add' && type !== null ? ['--type', type] : [])];
+        return { kind: 'wingfoil', source: 'built-in', argv, expectedCommit: { type: verb === 'add' ? type : null, verbs: [verb] } };
+    }
+    const typed = TYPED_STATE_RE.exec(name);
+    if (typed) {
+        const type = typed[1] === 'element' ? null : typed[1];
+        const verbs = typed[2] === 'set_state' ? ['approve', 'finalize', 'start'] : ['sync'];
+        return { kind: 'manual', source: 'built-in', expectedCommit: { type, verbs } };
+    }
+    if (name === 'element.set_release')
+        return { kind: 'manual', source: 'built-in', expectedCommit: { type: null, verbs: ['assign'] } };
+    if (name === 'config.init')
+        return { kind: 'wingfoil', source: 'built-in', argv: ['wingfoil', 'init'] };
+    if (name.startsWith('agent.'))
+        return { kind: 'agent', source: 'built-in', argv: ['wingfoil', 'agent', 'execute'] };
+    return null;
+}
+/**
+ * Resolve one token to its binding (spec-003 § "Action expressions" built-in table, Layer 3): an
+ * action resolves through the built-in table first, then `bindings.actions`; a check only through
+ * `bindings.checks` (no check is built in, and none may be bound to an agent). An unresolved token is
+ * `{ kind: 'unbound', source: 'none' }`. Pure and total: the same inputs give the same answer.
+ *
+ * @param token - The token as written in `actions:` / `checks:` / `awaits.evidence`, arguments included.
+ * @param role - Whether the token is an action or a check.
+ * @param bindings - The validated `bindings.yaml`, or `null` when the project has none.
+ */
+function resolveToken(token, role, bindings) {
+    const name = tokenName(token);
+    if (role === 'action') {
+        const builtin = builtinBinding(token, name);
+        if (builtin)
+            return builtin;
+        const bound = bindings?.actions?.[name];
+        if (bound)
+            return bound.manual === true ? { kind: 'manual', source: 'project' } : { kind: 'run', source: 'project', argv: bound.run };
+    }
+    else {
+        const bound = bindings?.checks?.[name];
+        if (bound)
+            return { kind: 'run', source: 'project', argv: bound.run, severity: bound.severity };
+    }
+    return { kind: 'unbound', source: 'none' };
+}
+/** A `{…}` placeholder anywhere in a string. */
+const PLACEHOLDER_RE = /\{[^{}]*\}/;
+/** A string that is one whole placeholder and nothing else. */
+const WHOLE_PLACEHOLDER_RE = /^\{[^{}]+\}$/;
+/** Whether one `run` element interpolates only as a whole element (`dl-090` Q3 (a)). */
+function isWholeInterpolation(element) {
+    return !PLACEHOLDER_RE.test(element) || WHOLE_PLACEHOLDER_RE.test(element);
+}
+/** The basename of a program path (`/usr/bin/wingfoil` → `wingfoil`; `dist/cli.js` → `cli.js`). */
+function basename(program) {
+    return program.slice(program.lastIndexOf('/') + 1);
+}
+/**
+ * Whether an argument vector runs `wingfoil agent execute` (`E_BINDING_AGENT_CHECK`, `dl-090` Q6): an
+ * `agent`, `execute` pair after a `wingfoil` program — called directly, through `npx`, or as the
+ * built `cli.js`.
+ */
+function runsAgentExecute(run) {
+    const wingfoilAt = run.findIndex((element) => basename(element) === 'wingfoil' || basename(element) === 'cli.js');
+    if (wingfoilAt === -1)
+        return false;
+    for (let i = wingfoilAt + 1; i < run.length - 1; i += 1) {
+        if (run[i] === 'agent' && run[i + 1] === 'execute')
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=bindings.js.map

package/dist/workflow/bindings.js.map

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

package/dist/workflow/create.d.ts

@@ -0,0 +1,13 @@
+/** What `workflow create` writes, after `--kind` has been read as the two booleans. */
+export interface NewWorkflow {
+    readonly name: string;
+    readonly startable: boolean;
+    readonly includable: boolean;
+    readonly element?: string;
+    readonly description?: string;
+}
+/** The phase every created workflow starts with (`spec-017` §7.7). */
+export declare const FIRST_PHASE_NAME = "step-1";
+/** The text of `.wingfoil/workflows/custom/<name>.yaml` for `workflow`, keys in a fixed order. Pure. */
+export declare function renderCustomWorkflow(workflow: NewWorkflow): string;
+//# sourceMappingURL=create.d.ts.map

package/dist/workflow/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/workflow/create.ts"],"names":[],"mappings":"AAaA,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAWzC,wGAAwG;AACxG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAQlE"}

package/dist/workflow/create.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIRST_PHASE_NAME = void 0;
+exports.renderCustomWorkflow = renderCustomWorkflow;
+/**
+ * The scaffold `wingfoil workflow create` writes (task-211, `spec-017` §7.7, P4.8). The Workflow pillar owns
+ * what a new workflow file *contains*; `src/core`'s `workflowCreate` composes it with the identity pre-flight,
+ * the uniqueness checks, the manifest edit and the commit. Pure (REQ-SYS-07): the same request always yields
+ * byte-identical text.
+ *
+ * The file is the smallest one `spec-003` Layer 2 accepts: `name`, the startable/includable declaration as the
+ * two booleans `dl-109` K1 (a) makes canonical (`--kind` maps onto them before this is called), the optional
+ * `description` and `element`, `version: 1.0`, and one phase `step-1` (Layer 2 requires one; it has no role, so
+ * it is a checkpoint until the author replaces it).
+ */
+const schema_1 = require("./schema");
+/** The phase every created workflow starts with (`spec-017` §7.7). */
+exports.FIRST_PHASE_NAME = 'step-1';
+/**
+ * A YAML scalar for `value`: plain when it is a name of `spec-003`'s class (nothing YAML could read otherwise),
+ * else double-quoted. JSON's string syntax is a subset of YAML's double-quoted scalar, so `JSON.stringify`
+ * escapes quotes, backslashes and control characters the way the YAML reader undoes them.
+ */
+function scalar(value) {
+    return schema_1.WORKFLOW_NAME_RE.test(value) ? value : JSON.stringify(value);
+}
+/** The text of `.wingfoil/workflows/custom/<name>.yaml` for `workflow`, keys in a fixed order. Pure. */
+function renderCustomWorkflow(workflow) {
+    const lines = [`name: ${workflow.name}`];
+    if (workflow.startable)
+        lines.push('startable: true');
+    if (workflow.includable)
+        lines.push('includable: true');
+    if (workflow.description !== undefined)
+        lines.push(`description: ${JSON.stringify(workflow.description)}`);
+    if (workflow.element !== undefined)
+        lines.push(`element: ${scalar(workflow.element)}`);
+    lines.push('version: 1.0', 'phases:', `  - name: ${exports.FIRST_PHASE_NAME}`);
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=create.js.map

package/dist/workflow/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/workflow/create.ts"],"names":[],"mappings":";;;AAmCA,oDAQC;AA3CD;;;;;;;;;;GAUG;AACH,qCAA4C;AAW5C,sEAAsE;AACzD,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;;;GAIG;AACH,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,yBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,wGAAwG;AACxG,SAAgB,oBAAoB,CAAC,QAAqB;IACxD,MAAM,KAAK,GAAG,CAAC,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC3G,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,aAAa,wBAAgB,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}